From a2e69c03580a8e99d1e8be60ffc492812804620e Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 09:18:19 +0000 Subject: [PATCH 1/2] Initial plan From 97c0622c4a8acc09d544befe125d63be1625c620 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6?= Date: Thu, 7 May 2026 10:43:46 +0200 Subject: [PATCH 2/2] Document Nextcloud 25 avatar size and dark-theme changes Co-authored-by: skjnldsv <14975046+skjnldsv@users.noreply.github.com> --- .../release_notes/previous/upgrade_to_25.rst | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/developer_manual/release_notes/previous/upgrade_to_25.rst b/developer_manual/release_notes/previous/upgrade_to_25.rst index 3c231a9235b..e8c087126b6 100644 --- a/developer_manual/release_notes/previous/upgrade_to_25.rst +++ b/developer_manual/release_notes/previous/upgrade_to_25.rst @@ -49,6 +49,28 @@ The `christophwurst/nextcloud `_ package. The content is the same and all older versions were generated, so you can transition right away no matter which versions you support. +Avatar generation and avatar URL changes +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Nextcloud 25 changed the behavior of generated avatars. + +If your app or integration requests avatar images directly, note the following: + +* Deprecated avatar sizes are normalized to supported sizes: + + * requests for sizes up to ``64`` return a ``64x64`` avatar + * requests for sizes above ``64`` return a ``512x512`` avatar + +* Dark theme variants of generated avatars are available through dedicated endpoints: + + * ``/avatar/{userId}/{size}/dark`` + * ``/avatar/guest/{guestName}/{size}/dark`` + +* Generated avatars may have a different appearance in dark mode than in light mode. + +Apps should not assume that arbitrary requested avatar sizes are returned unchanged. +If you need dark-mode aware generated avatars, use the ``/dark`` endpoints. + Removed APIs ^^^^^^^^^^^^