From 41c5a0ca2fb9dc6b5652a920afa0a47ecb5f9032 Mon Sep 17 00:00:00 2001
From: Mees Frensel <33722705+meesfrensel@users.noreply.github.com>
Date: Fri, 23 Jan 2026 15:42:21 +0100
Subject: [PATCH] fix(docs): document that fullsize thumbnail might redirect to
 original (#25416)

---
 mobile/openapi/lib/api/assets_api.dart        | Bin 55347 -> 55553 bytes
 open-api/immich-openapi-specs.json            |   2 +-
 .../src/controllers/asset-media.controller.ts |   3 ++-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/mobile/openapi/lib/api/assets_api.dart b/mobile/openapi/lib/api/assets_api.dart
index 03d91c9daeabaebdebbcea27e5dbc145a7e1406b..e737397fc8176da32e8a1723fe5e7826041385d4 100644
GIT binary patch
delta 237
zcmdnIfw^%L^M*_3(iFlnQ_C~+(iKWFQWerlb8?C^t5SiS(%huH#LOIp+|2Zh5{07F
zl+2>k<PwFFe1(+!^1Ph<#1zNk;?xoyh4PHd<P4yK!cw4$VueJ7l+3iW)S}e95`}`)
mqTI~l;>`TK%@@x_u+qt{$%W<qlkHEiO@5$bym`ZwW@Z3t8eOFT

delta 53
zcmZqN#JqU}^M*_3CM$$@PPRY6Hu-^$@#J_z)=d{CuuOgs<%cXb>4N#@U02<i0hyN=
A3IG5A

diff --git a/open-api/immich-openapi-specs.json b/open-api/immich-openapi-specs.json
index 28b61c421..fb329d265 100644
--- a/open-api/immich-openapi-specs.json
+++ b/open-api/immich-openapi-specs.json
@@ -4279,7 +4279,7 @@
     },
     "/assets/{id}/thumbnail": {
       "get": {
-        "description": "Retrieve the thumbnail image for the specified asset.",
+        "description": "Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.",
         "operationId": "viewAsset",
         "parameters": [
           {
diff --git a/server/src/controllers/asset-media.controller.ts b/server/src/controllers/asset-media.controller.ts
index 3ef63ff7f..ec6083cfa 100644
--- a/server/src/controllers/asset-media.controller.ts
+++ b/server/src/controllers/asset-media.controller.ts
@@ -147,7 +147,8 @@ export class AssetMediaController {
   @Authenticated({ permission: Permission.AssetView, sharedLink: true })
   @Endpoint({
     summary: 'View asset thumbnail',
-    description: 'Retrieve the thumbnail image for the specified asset.',
+    description:
+      'Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.',
     history: new HistoryBuilder().added('v1').beta('v1').stable('v2'),
   })
   async viewAsset(