From 9ea0a69a729fec6723db298ed62da42e5950dc6d Mon Sep 17 00:00:00 2001
From: aviv926 <51673860+aviv926@users.noreply.github.com>
Date: Mon, 23 Feb 2026 23:21:06 +0200
Subject: [PATCH] feat(docs): Adding information about parameter c= (#26430)

* Adding information about parameter c=

* Apply suggestions from code review

Co-authored-by: bo0tzz <git@bo0tzz.me>

---------

Co-authored-by: Jason Rasmussen <jason@rasm.me>
Co-authored-by: bo0tzz <git@bo0tzz.me>
---
 mobile/openapi/lib/model/asset_response_dto.dart | 2 +-
 open-api/immich-openapi-specs.json               | 2 +-
 open-api/typescript-sdk/src/fetch-client.ts      | 2 +-
 server/src/dtos/asset-response.dto.ts            | 5 ++++-
 4 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/mobile/openapi/lib/model/asset_response_dto.dart b/mobile/openapi/lib/model/asset_response_dto.dart
index 5422ccf55f..078dd0bdaf 100644
--- a/mobile/openapi/lib/model/asset_response_dto.dart
+++ b/mobile/openapi/lib/model/asset_response_dto.dart
@@ -156,7 +156,7 @@ class AssetResponseDto {
 
   List<TagResponseDto> tags;
 
-  /// Thumbhash for thumbnail generation
+  /// Thumbhash for thumbnail generation (base64) also used as the c query param for thumbnail cache busting.
   String? thumbhash;
 
   /// Asset type
diff --git a/open-api/immich-openapi-specs.json b/open-api/immich-openapi-specs.json
index d519e53ce3..264781db59 100644
--- a/open-api/immich-openapi-specs.json
+++ b/open-api/immich-openapi-specs.json
@@ -17070,7 +17070,7 @@
             "type": "array"
           },
           "thumbhash": {
-            "description": "Thumbhash for thumbnail generation",
+            "description": "Thumbhash for thumbnail generation (base64) also used as the c query param for thumbnail cache busting.",
             "nullable": true,
             "type": "string"
           },
diff --git a/open-api/typescript-sdk/src/fetch-client.ts b/open-api/typescript-sdk/src/fetch-client.ts
index 8fda52e9ee..8f65e59cfa 100644
--- a/open-api/typescript-sdk/src/fetch-client.ts
+++ b/open-api/typescript-sdk/src/fetch-client.ts
@@ -616,7 +616,7 @@ export type AssetResponseDto = {
     resized?: boolean;
     stack?: (AssetStackResponseDto) | null;
     tags?: TagResponseDto[];
-    /** Thumbhash for thumbnail generation */
+    /** Thumbhash for thumbnail generation (base64) also used as the c query param for thumbnail cache busting. */
     thumbhash: string | null;
     /** Asset type */
     "type": AssetTypeEnum;
diff --git a/server/src/dtos/asset-response.dto.ts b/server/src/dtos/asset-response.dto.ts
index df02a0cdea..a76df4abaa 100644
--- a/server/src/dtos/asset-response.dto.ts
+++ b/server/src/dtos/asset-response.dto.ts
@@ -25,7 +25,10 @@ export class SanitizedAssetResponseDto {
   id!: string;
   @ValidateEnum({ enum: AssetType, name: 'AssetTypeEnum', description: 'Asset type' })
   type!: AssetType;
-  @ApiProperty({ description: 'Thumbhash for thumbnail generation' })
+  @ApiProperty({
+    description:
+      'Thumbhash for thumbnail generation (base64) also used as the c query param for thumbnail cache busting.',
+  })
   thumbhash!: string | null;
   @ApiPropertyOptional({ description: 'Original MIME type' })
   originalMimeType?: string;