feat: openapi specs for remove_approvers_from_report_api

reference/admin.yaml

@@ -4027,6 +4027,26 @@ components:
       description: |
         Explanation to the action if provided by the user
       example: All bills are in order
+    remove_approvers_bulk_in:
+      type: object
+      additionalProperties: false
+      required:
+        - id
+        - approver_emails
+      properties:
+        id:
+          type: string
+          description: |
+            id of report, from which the approvers need to be removed
+          example: rpa21A2rdj2
+        approver_emails:
+          type: array
+          items:
+            allOf:
+              - $ref: '#/components/schemas/email'
+          example:
+            - adb@gmail.com
+            - kartikey.rajvaidya@fyle.in
     process_ach_in:
       type: object
       properties:
@@ -12523,6 +12543,61 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/404'
+  /admin/reports/remove_approvers:
+    post:
+      tags:
+        - Reports
+      summary: Remove Approvers
+      description: |
+        Remove Approvers
+      operationId: report_remove_approvers
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: false
+              required:
+                - data
+              properties:
+                data:
+                  $ref: '#/components/schemas/remove_approvers_bulk_in'
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                additionalProperties: false
+                properties:
+                  data:
+                    $ref: '#/components/schemas/admin_report_out'
+        '400':
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/400'
+        '401':
+          description: Unauthorized request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/401'
+        '403':
+          description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/403'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/404'
   /admin/reports/process_ach/bulk:
     post:
       tags:

src/admin/openapi.yaml

@@ -188,6 +188,8 @@ paths:
     $ref: paths/admin@reports.yaml
   /admin/reports/eject_expenses:
     $ref: 'paths/admin@reports@eject_expenses.yaml'
+  /admin/reports/remove_approvers:
+    $ref: 'paths/admin@reports@remove_approvers.yaml'
   /admin/reports/process_ach/bulk:
     $ref: paths/admin@reports@process_ach@bulk.yaml
   /admin/reports/mark_paid/bulk:

src/admin/paths/admin@reports@remove_approvers.yaml

@@ -0,0 +1,54 @@
+post:
+  tags:
+    - Reports
+  summary: Remove Approvers
+  description: |
+    Remove Approvers
+  operationId: report_remove_approvers
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          additionalProperties: False
+          required:
+            - data
+          properties:
+            data:
+              $ref: ../../components/schemas/report.yaml#/remove_approvers_bulk_in
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            type: object
+            additionalProperties: False
+            properties:
+              data:
+                $ref: '../../components/schemas/report.yaml#/admin_report_out'
+    '400':
+      description: Bad request
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/400.yaml
+    '401':
+      description: Unauthorized request
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/401.yaml
+    '403':
+      description: Forbidden
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/403.yaml
+    '404':
+      description: Not Found
+      content:
+        application/json:
+          schema:
+            $ref: '../../components/schemas/404.yaml'

src/components/schemas/report.yaml

@@ -488,6 +488,25 @@ report_action_with_expenses_ids_to_eject:
           - $ref: './fields.yaml#/id_string'
       example: [ 'txelntgwgwll' ]
 
+remove_approvers_bulk_in:
+  type: object
+  additionalProperties: False
+  required:
+    - id
+    - approver_emails
+  properties:
+    id:
+      type: string
+      description: |
+        id of report, from which the approvers need to be removed
+      example: 'rpa21A2rdj2'
+    approver_emails:
+      type: array
+      items:
+        allOf:
+          - $ref: './fields.yaml#/email'
+      example: [ "adb@gmail.com", "kartikey.rajvaidya@fyle.in" ]
+
 report_action_submit:
   type: object
   additionalProperties: False