Automated commit 'ISCAIM-22142: added docs for beta/identities/:id/re…

…set endpoint (#1607)' by github action: 8379466621

idn/beta/paths/identity-reset.yaml

@@ -0,0 +1,34 @@
+post:
+  operationId: resetIdentity
+  tags:
+    - Identities
+  summary: Reset an identity
+  description: >-
+    Use this endpoint to reset a user's identity if they have forgotten their authentication information like their answers to knowledge-based questions.
+    Resetting an identity de-registers the user and removes any elevated user levels they have.
+  security:
+    - UserContextAuth:
+        - "idn:identity:update"
+  parameters:
+    - in: path
+      name: identityId
+      schema:
+        type: string
+      required: true
+      description: Identity Id
+      example: "ef38f94347e94562b5bb8424a56397d8"
+  responses:
+    "202":
+      description: Accepted. The reset request accepted and is in progress.
+    "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/sailpoint-api.beta.yaml

@@ -1247,6 +1247,8 @@ paths:
     $ref: './beta/paths/identity.yaml'
   /identities/process:
     $ref: './beta/paths/identities-process.yaml'
+  /identities/{id}/reset:
+    $ref: './beta/paths/identity-reset.yaml'
   /identities/{identityId}/role-assignments/{assignmentId}:
     $ref: './beta/paths/identities-role-assignment.yaml'
   /identities/{identityId}/role-assignments: