developer.sailpoint.com/static/api-specs/idn/beta/paths/identity-set-lifecycle-state.yaml

post:
  operationId: setLifecycleState
  tags:
    - Lifecycle States
  summary: Set Lifecycle State
  description: |
    This endpoint will set/update an identity's lifecycle state to the one provided and updates the corresponding Identity Profile.

    A token with ORG_ADMIN or API authority is required to call this API.
  parameters:
    - in: path
      name: identity-id
      description: >-
        The ID of the identity to update
      required: true
      example: 2c9180857893f1290178944561990364
      schema:
        type: string
        format: uuid
  requestBody:
    required: true
    content:
      application/json:
        schema:
         type: object
         properties:
           lifecycleStateId:
             type: string
             format: uuid
             description: The ID of the lifecycle state to set
             example: 2c9180877a86e408017a8c19fefe046c
  responses:
    '200':
      description: OK - Returned if the request was successfully accepted into the system.
      content:
        application/json:
          schema:
            type: object
            properties:
              accountActivityId:
                type: string
                format: uuid
                example: 2c9180837ab5b716017ab7c6c9ef1e20
                description: The ID of the IdentityRequest object that was generated when the workflow launches
    '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'