From ea4f661b3ac53258bdf1026757db8d0c44844d79 Mon Sep 17 00:00:00 2001 From: Katerina Skroumpelou Date: Wed, 3 Dec 2025 17:37:20 +0200 Subject: [PATCH] docs(storage): clarify upsert has no effect in uploadToSignedUrl --- packages/core/storage-js/src/packages/StorageFileApi.ts | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/core/storage-js/src/packages/StorageFileApi.ts b/packages/core/storage-js/src/packages/StorageFileApi.ts index b271c425e..53ba2859a 100644 --- a/packages/core/storage-js/src/packages/StorageFileApi.ts +++ b/packages/core/storage-js/src/packages/StorageFileApi.ts @@ -236,7 +236,9 @@ export default class StorageFileApi { * @param path The file path, including the file name. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to upload. * @param token The token generated from `createSignedUploadUrl` * @param fileBody The body of the file to be stored in the bucket. - * @param fileOptions Optional file upload options including cacheControl and contentType. + * @param fileOptions HTTP headers (cacheControl, contentType, etc.). + * **Note:** The `upsert` option has no effect here. To enable upsert behavior, + * pass `{ upsert: true }` when calling `createSignedUploadUrl()` instead. * @returns Promise with response containing file path and fullPath or error * * @example Upload to a signed URL