Automated commit 'Merge pull request #1925 from sailpoint/ISCARP-15664

ISCARP-15664: Updated documentation to cover bulk approve endpoint.' by github action: 12524629764

idn/sailpoint-api.v2024.yaml

@@ -1295,6 +1295,9 @@ paths:
     $ref: ./v3/paths/forward-access-request-approval.yaml
   /access-request-approvals/approval-summary:
     $ref: ./v3/paths/access-request-approval-summary.yaml
+  /access-request-approvals/bulk-approve:
+   $ref: './v2024/paths/access-request-bulk-approve.yaml'
+
   /accounts:
     $ref: ./v3/paths/accounts.yaml
   /accounts/{id}:

idn/v2024/paths/access-request-bulk-approve.yaml

@@ -0,0 +1,39 @@
+post:
+  operationId: approveBulkAccessRequest
+  security:
+    - userAuth: [ idn:access-request-administration:write ]
+  x-sailpoint-userLevels:
+    - ORG_ADMIN
+  tags:
+    - Access Requests
+  summary: Bulk Approve Access Request
+  description: >-
+    This API endpoint allows approving pending access requests in bulk. Maximum of 50 approval ids can be 
+    provided in the request for one single invocation. 
+    ORG_ADMIN or users with rights "idn:access-request-administration:write" can approve the access requests in bulk.
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          $ref: '../schemas/BulkApproveAccessRequest.yaml'
+        example:
+          {
+            "accessRequestIds": ["2c91808568c529c60168cca6f90c1313","2c91808568c529c60168cca6f90c1314"],
+            "comment": "I approve these request items"
+          }
+  responses:
+    '202':
+      $ref: '../../v3/responses/202.yaml'
+    '400':
+      $ref: '../../v3/responses/400.yaml'
+    '401':
+      $ref: '../../v3/responses/401.yaml'
+    '403':
+      $ref: '../../v3/responses/403.yaml'
+    '404':
+      $ref: '../../v3/responses/404.yaml'
+    '429':
+      $ref: '../../v3/responses/429.yaml'
+    '500':
+      $ref: '../../v3/responses/500.yaml'

idn/v2024/schemas/BulkApproveAccessRequest.yaml

@@ -0,0 +1,17 @@
+type : object
+description: Request body payload for bulk approve access request endpoint.
+required :
+  - approvalIds
+  - comment
+properties:
+  approvalIds:
+    type: array
+    description: List of approval ids to approve the pending requests
+    items:
+      type: string
+    example: [2c9180835d2e5168015d32f890ca1581, 2c9180835d2e5168015d32f890ca1582]
+
+  comment:
+    type: string
+    description: Reason for approving the pending access request.
+    example: "I approve these request items"