cancel
Showing results for 
Search instead for 
Did you mean: 
dylanwan
Employee
Employee

When an employee leaves the company or transfers from one role to another, how can we handle the object ownership from Incorta?

Incorta provides the object ownership transfer process by initiating the Delete User process flow.  This task can be done by an admin with a User Management role.

Manual Option

1. Login as the admin user

2. Go to the Security page

dylanwan_0-1649355999422.png

3. Select the user you would like to transfer his or her objects.

dylanwan_1-1649355999426.png

4. Click on Delete, and Select the option to transfer the ownership to a desired user

dylanwan_2-1649355999436.png

5. Optionally, check Transfer Sharing Permissions if you want to transfer the objects that are shared with the former employee to the desired user

dylanwan_3-1649355999450.png

6. After you transfer ownership of all objects, you will be prompted to confirm the deletion.  If you would like to keep the user, click on cancel.

Please note that after transferring the objects to the desired user, the dashboard objects may be shown under the root and if the user has already had a different set of the dashboards or folders, you may see duplicated objects.

Programmatic Option

Refer to the API documentation around the endpoint designated to transfer ownership. Note that the following must be in place to transfer ownership:
  ●  The new owner must be assigned roles similar to or higher than those assigned to the original owner.
  ●  The new owner must be an active user. 

Spoiler
If the endpoint fails to transfer the ownership of any of the entities, the whole operation fails. The system tracks ownership transfers for audit purposes.
Request URL
https://<cluster_URL>/incorta/api/v2/{tenantName}/users/transferOwnership
Request Headers
{
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {access_token}"
}
Request Body
{
  "ownerEmail": "string",
  "newOwnerEmail": "string",
  "transferSharingPermission": boolean
}
Best Practices Index
Best Practices

Just here to browse knowledge? This might help!

Contributors
Version history
Last update:
‎08-22-2023 07:22 AM
Updated by: