Automated commit 'IDNARSENAL-18279: a couple tweaks to the /identitie…

…s/process endpoint docs (#1464)

* IDNARSENAL-18279: a couple tweaks to the /identities/process endpoint docs

* IDNARSENAL-18279: fix description

* IDNARSENAL-18279: line format' by github action: 6631941173

idn/beta/paths/identities-process.yaml

@@ -12,6 +12,8 @@ post:
     5. Potentially clean-up identity processing errors, assuming the error has been resolved.
     
     To learn more, refer to the [identity processing documentation](https://documentation.sailpoint.com/saas/help/setup/identity_processing.html).
+
+    A token with ORG_ADMIN or HELPDESK authority is required to call this API.
   security:
     - UserContextAuth:
         - "idn:identity:manage"
@@ -27,7 +29,7 @@ post:
       content:
         application/json:
           schema:
-            $ref: "../schemas/BaseReferenceDto.yaml"
+            $ref: "../schemas/TaskResultResponse.yaml"
     "400":
       $ref: "../../v3/responses/400.yaml"
     "401":

idn/beta/schemas/TaskResultResponse.yaml

@@ -0,0 +1,14 @@
+type: object
+properties:
+  type:
+    type: string
+    description: the type of response reference
+    example: "TASK_RESULT"
+  id:
+    type: string
+    description: the task ID
+    example: "78733556-9ea3-4f59-bf69-e5cd92b011b4"
+  name:
+    type: string
+    description: the task name (not used in this endpoint, always null)
+    example: "null"