Add virus file endpoints

Author: simonhammes

system_admin_account_operations.yaml

@@ -3392,6 +3392,102 @@ paths:
                   ],
                   "count": 2
                 }
+  /api/v2.1/admin/virus-files/:
+    get:
+      tags:
+        - Logs
+      summary: List Virus Files
+      operationId: listVirusFiles
+      description: |
+        Returns a list of files that were detected by the virus scanner.
+
+        Note: The API returns different fields per object depending on the workspace ownership (group vs. personal workspaces).
+      security:
+        - AccountTokenAuth: []
+      parameters:
+        - $ref: "#/components/parameters/page"
+        - $ref: "#/components/parameters/per_page"
+        - in: query
+          name: has_handled
+          schema:
+            type: string
+            enum: [true, false, null]
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              example:
+                virus_file_list:
+                  - repo_id: 696b27df-173e-4628-8ac2-10347c58a428
+                    file_path: /asset/af5fa655-ef97-4573-8f2d-c3812e17a548/files/2024-08/eicar.com.txt
+                    has_deleted: true
+                    has_ignored": false,
+                    virus_id: 1
+                    group_id: 1,
+                    group_name: group-11
+                    org_id: 1
+                    org_name: org-1
+                    dtable_uuid: af5fa655-ef97-4573-8f2d-c3812e17a548
+                    dtable_name: rows
+                  - repo_id: 696b27df-173e-4628-8ac2-10347c58a428
+                    file_path: /asset/af5fa655-ef97-4573-8f2d-c3812e17a548/files/2024-08/eicar.com (1).txt
+                    has_deleted: false
+                    has_ignored: false
+                    virus_id: 2,
+                    username: ac8961c4118f4400ad71bada398675b7@auth.local
+                    nickname: test@demo.com
+                    org_id: 1
+                    org_name: org-1
+                    dtable_uuid: af5fa655-ef97-4573-8f2d-c3812e17a548
+                    dtable_name: rows
+                has_next_page: false
+  /api/v2.1/admin/virus-files/{virus_id}/:
+    put:
+      tags:
+        - Logs
+      summary: Update Virus File
+      operationId: updateVirusFile
+      description: Updates the status of a virus file.
+      security:
+        - AccountTokenAuth: []
+      parameters:
+        - in: path
+          name: virus_id
+          required: true
+          schema:
+            type: integer
+          description: The ID of the virus file
+      requestBody:
+        required: true
+        content:
+          application/x-www-form-urlencoded:
+            schema:
+              type: object
+              properties:
+                ignore:
+                  type: string
+                  enum: [true, false]
+              required:
+                - ignore
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              example:
+                virus_file:
+                  repo_id: 696b27df-173e-4628-8ac2-10347c58a428
+                  file_path: /asset/af5fa655-ef97-4573-8f2d-c3812e17a548/files/2024-08/eicar.com (1).txt
+                  has_deleted: false
+                  has_ignored: true
+                  virus_id: 2
+                  group_id: 1
+                  group_name: group-11
+                  org_id: 1
+                  org_name: org-1
+                  dtable_uuid: af5fa655-ef97-4573-8f2d-c3812e17a548
+                  dtable_name: rows
 
   # Plugins
   /api/v2.1/admin/dtable-system-plugins/: