Description
Use Case
When an Image Artist user account is removed, but their datasets must remain accessible to team members or groups, ownership needs to be transferred to another active user without losing data integrity or access.
Prerequisites & Warning
- Backup Required: Always confirm a valid system/data backup before performing ownership changes. (Image Artist: Data backup)
- Admin Access: Required to access the Datastore API and retrieve user IDs.
Manual Ownership Reassignment (Datastore API)
Supported Versions
- Available in Image Artist 1.3 and above
Workflow to reassign ownership:
- Authenticate: Connect and authenticate against the Datastore API Swagger interface. Refer to the knowledge article: Image Artist: Accessing the Datastore API Swagger interface
-
Navigate: Go to the
PUT /change_owner/{old_owner_id}/{new_owner_id}endpoint, then click "Try it out".
-
Execute: Enter the
old_owner_id(current owner) and thenew_owner_id(new owner), then click "Execute".
All datasets belonging to the old_owner_id will be reassigned to the new_owner_id. It may take a few moments for the changes to reflect in the Image Artist web interface.
Note: Result files, Analysis files, Assay Definition files, and other types of annotations will retain the old owner information. Their visibility/accessibility in the Image Artist web interface is defined by the parent resource (screen/plate/measurement) which should now use the new_owner_id.
Limitations: Selective reassignment of individual datasets is not currently supported.
Identifying the owner ID:
The owner ID is found in the Image Artist web interface under the User Info table. Log in is as the Image Artist admin, select a user from the data tree, and the User Info table will display the "ID" (owner ID).
Automated Ownership Reassignment
Supported Version
- Available from Image Artist 1.3.77
Configuration
Add the following line to custom.env which is found inside the ImA installation directory:
CHANGE_OWNERSHIP_OF_CHANGED_USER_IDS=true
How It Works
- Automatically reassigns orphaned data when:
- A user is recreated with the same username
- The userID has changed
- Runs during the next meta-update cycle (background process)
Activation
- Redeploy the Image Artist stack after making the change (Image Artist: How do I redeploy/restart the container stack?)
Disable
- Remove the variable from
custom.env
Comments
0 comments
Article is closed for comments.