chore(uploads): clarify finalized upload retention period

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- chore(uploads): clarify finalized upload retention period
 - chore(loads): clarify idempotency key conflict behavior
 - chore(uploads): clarify finalize token validation errors
 - feat(jobs): add ivf_index_hold job type support

docs/UploadsApi.md

@@ -203,6 +203,8 @@ Finalize upload
 
 Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected.
 
+Load a finalized upload within 7 days (by default). An upload that has not been loaded by then is deleted, and loading it afterwards fails as not found.
+
 ### Example
 
 * Api Key Authentication (WorkspaceId):

hotdata/api/uploads_api.py

@@ -629,7 +629,7 @@ def finalize_upload_handler(
     ) -> FinalizeUploadResponse:
         """Finalize upload
 
-        Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected.
+        Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected.  Load a finalized upload within 7 days (by default). An upload that has not been loaded by then is deleted, and loading it afterwards fails as not found.
 
         :param upload_id: Upload session ID returned at create time (required)
         :type upload_id: str
@@ -706,7 +706,7 @@ def finalize_upload_handler_with_http_info(
     ) -> ApiResponse[FinalizeUploadResponse]:
         """Finalize upload
 
-        Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected.
+        Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected.  Load a finalized upload within 7 days (by default). An upload that has not been loaded by then is deleted, and loading it afterwards fails as not found.
 
         :param upload_id: Upload session ID returned at create time (required)
         :type upload_id: str
@@ -783,7 +783,7 @@ def finalize_upload_handler_without_preload_content(
     ) -> RESTResponseType:
         """Finalize upload
 
-        Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected.
+        Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected.  Load a finalized upload within 7 days (by default). An upload that has not been loaded by then is deleted, and loading it afterwards fails as not found.
 
         :param upload_id: Upload session ID returned at create time (required)
         :type upload_id: str