From 02dba97f83ae1f2f322a3f5727d52fe2dc75be37 Mon Sep 17 00:00:00 2001 From: "hotdata-automation[bot]" <267177015+hotdata-automation[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:44:52 +0000 Subject: [PATCH] chore(uploads): clarify finalized upload retention period --- CHANGELOG.md | 1 + docs/UploadsApi.md | 2 ++ hotdata/api/uploads_api.py | 6 +++--- 3 files changed, 6 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c8f4afa..bcd51f8 100644 --- a/CHANGELOG.md +++ b/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 diff --git a/docs/UploadsApi.md b/docs/UploadsApi.md index 3daff50..99ef4fb 100644 --- a/docs/UploadsApi.md +++ b/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): diff --git a/hotdata/api/uploads_api.py b/hotdata/api/uploads_api.py index 33007d9..533e8e9 100644 --- a/hotdata/api/uploads_api.py +++ b/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