Resolution Steps

1. Export Legacy Avatar Metadata:
   • Run a SQL query against your current database to extract user_id, avatar_name, avatar_theme and avatar_collection.
2. Download High-Resolution Avatar Images:
   • For each user, use the following API to download images:

     GET https://your_instance.domain.com/t5/image/serverpage/avatar-name/{AVATAR_NAME}/avatar-theme/{THEME}/avatar-collection/{COLLECTION}/avatar-display-size/print/version/2

   • Save each file locally as {USER_ID}.png or .jpg.
3. Upload Images to Aurora:
   • Sign in as an admin and navigate to Designer → Theme → Avatars → Add custom avatars.
   • Upload all images, ensuring they are square and at least 300 px.
   • Publish the theme, maintaining the folder hierarchy.
4. Confirm Avatar Permissions:
   • Ensure the role running the script has permissions for "Upload own avatar" and "Choose avatar from collections".
5. Attach Avatar to User Profiles:
   • Aurora’s GraphQL API doesn’t expose user avatars yet, so use the classic v1 admin REST endpoint that updates the url_icon profile field:

     POST /users/id/{USER_ID}/profiles/name/url_icon/set?value=avatar:{THEME}/{COLLECTION}/{AVATAR_NAME}

   • Example cURL command:

     curl -X POST -H "Li-Api-Session-Key: YOUR_ADMIN_SESSION_KEY" "https://your_instance.domain.com/users/id/117600/profiles/name/url_icon/set?value=avatar:candy/architecture/orthodox"

Best Practices:

• Use an admin-level session key for modifications.
• Overwrite files with the same name to avoid broken links if images need updating.

Additional API for High-Resolution Images:

• Use /users/id/{USER_ID}/profiles/avatar/size/print or /users/id/{USER_ID}/profiles/avatar/size/unspecified for fetching high-resolution images.