Skip to content

High performance self-hosted photo and video management solution.

fix(docs): document that fullsize thumbnail might redirect to original (#25416)

Mees Frensel41c5a0ca2fb9
diff --git a/mobile/openapi/lib/api/assets_api.dart b/mobile/openapi/lib/api/assets_api.dart
index 03d91c9dae..e737397fc8 100644
--- a/mobile/openapi/lib/api/assets_api.dart
+++ b/mobile/openapi/lib/api/assets_api.dart
@@ -1691,7 +1691,7 @@ class AssetsApi {
/// View asset thumbnail
///
- /// Retrieve the thumbnail image for the specified asset.
+ /// Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.
///
/// Note: This method returns the HTTP [Response].
///
@@ -1747,7 +1747,7 @@ class AssetsApi {
/// View asset thumbnail
///
- /// Retrieve the thumbnail image for the specified asset.
+ /// Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.
///
/// Parameters:
///
diff --git a/open-api/immich-openapi-specs.json b/open-api/immich-openapi-specs.json
index 28b61c421e..fb329d2653 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 3ef63ff7f9..ec6083cfa8 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(