Update the current user
Updates preferences on the authenticated user’s own account. Only the fields included in the request body are changed. This endpoint does not accept a user ID; it always updates the authenticated caller. Returns 404, without changing anything, when immich_library_id names a library the caller cannot choose; the response is the same whether or not that library exists.
Authorizations
Gumnut API key (apikey_...) sent as a Bearer token in the Authorization header. Create and manage keys in the Gumnut app, or with the API key endpoints while signed in to it.
Body
Updatable fields on the authenticated user's own account.
Preferred favorite/rating display mode. Omit to leave unchanged; send null to reset to the default (favorite mode).
favorite, rating Enable demo-mode person-name presentation. Omit to leave unchanged; send false to disable. Explicit null is not accepted.
Preferred library. Must be a live library the caller owns or has the collaborator role in, and that the request's credential can access; any other id returns 404. Omit to leave unchanged; send null to clear the preference and use the default.
Response
Successful Response
Represents a user account with profile information.
Unique user identifier with 'intuser_' prefix
The user's effective favorite/rating display mode, defaulting to favorite when they have never selected one.
favorite, rating Whether demo-mode person-name presentation is enabled. Defaults to false.
Whether this user account is currently active
Whether this user has superuser/admin privileges
Whether the account is marked verified. An internal account flag, not proof of email verification — it can be true even when email is null
Total bytes of assets the user is currently storing
Maximum bytes of assets the user may store
When this user account was created
When this user account was last updated
User's email address
User's first name
User's last name
User's home timezone as an IANA zone id (e.g. 'America/Los_Angeles'); null until a home zone is captured
The user's stored preferred library, or null to use the default. Reported as stored: the library may since have been trashed, or the user's access to it may have changed.