From a06ee85889b4e7a76c454cc1e01c9046d71729ce Mon Sep 17 00:00:00 2001 From: "dropbox-sdk-updater[bot]" <306210582+dropbox-sdk-updater[bot]@users.noreply.github.com> Date: Thu, 10 Sep 2026 20:21:37 +0000 Subject: [PATCH] Automated Spec Update e733a5105a817d9a93e5c0f16f39d467d3e2072c Automated update of the API specification Co-authored-by: dropbox-spec-updater[bot] <306253022+dropbox-spec-updater[bot]@users.noreply.github.com> --- dropbox/base.py | 29 ++++++++++++++++++++--------- dropbox/files.py | 12 ++++++++---- spec | 2 +- 3 files changed, 29 insertions(+), 14 deletions(-) diff --git a/dropbox/base.py b/dropbox/base.py index d1ecadc..c4fe20f 100644 --- a/dropbox/base.py +++ b/dropbox/base.py @@ -966,7 +966,9 @@ def files_alpha_upload( :param bytes f: Contents to upload. :param content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an - error will be returned. For more information see our `Content hash + error will be returned. Optional, but recommended to avoid + committing data corrupted in transit. For more information see our + `Content hash `_ page. :type content_hash: Nullable[str] :rtype: :class:`dropbox.files.FileMetadata` @@ -3298,7 +3300,9 @@ def files_upload( :param bytes f: Contents to upload. :param content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an - error will be returned. For more information see our `Content hash + error will be returned. Optional, but recommended to avoid + committing data corrupted in transit. For more information see our + `Content hash `_ page. :type content_hash: Nullable[str] :rtype: :class:`dropbox.files.FileMetadata` @@ -3389,7 +3393,9 @@ def files_upload_session_append_v2(self, f, cursor, close=False, content_hash=No :type close: bool :param content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an - error will be returned. For more information see our `Content hash + error will be returned. Optional, but recommended to avoid + committing data corrupted in transit. For more information see our + `Content hash `_ page. :type content_hash: Nullable[str] :rtype: None @@ -3427,10 +3433,11 @@ def files_upload_session_append_batch(self, f, entries, content_hash=None): :param bytes f: Contents to upload. :param entries: Append information for each file in the batch. :type entries: List[:class:`dropbox.files.UploadSessionAppendBatchArgEntry`] - :param content_hash: A hash of the entire request body which is all the - concatenated pieces of file content that were uploaded in this call. - If provided and the uploaded content does not match this hash, an - error will be returned. For more information see our `Content hash + :param content_hash: A single hash of all the concatenated file contents + uploaded in this call. If provided and the uploaded content does not + match this hash, an error will be returned. Optional, but + recommended to avoid committing data corrupted in transit. For more + information see our `Content hash `_ page. :type content_hash: Nullable[str] :rtype: :class:`dropbox.files.UploadSessionAppendBatchResult` @@ -3470,7 +3477,9 @@ def files_upload_session_finish(self, f, cursor, commit, content_hash=None): :type commit: :class:`dropbox.files.CommitInfo` :param content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an - error will be returned. For more information see our `Content hash + error will be returned. Optional, but recommended to avoid + committing data corrupted in transit. For more information see our + `Content hash `_ page. :type content_hash: Nullable[str] :rtype: :class:`dropbox.files.FileMetadata` @@ -3652,7 +3661,9 @@ def files_upload_session_start(self, f, close=False, session_type=None, content_ :type session_type: Nullable[:class:`dropbox.files.UploadSessionType`] :param content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an - error will be returned. For more information see our `Content hash + error will be returned. Optional, but recommended to avoid + committing data corrupted in transit. For more information see our + `Content hash `_ page. :type content_hash: Nullable[str] :rtype: :class:`dropbox.files.UploadSessionStartResult` diff --git a/dropbox/files.py b/dropbox/files.py index 3711fd8..a9dc858 100644 --- a/dropbox/files.py +++ b/dropbox/files.py @@ -10181,6 +10181,7 @@ class UploadArg(CommitInfo): :ivar UploadArg.content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an error will be returned. + Optional, but recommended to avoid committing data corrupted in transit. For more information see our `Content hash `_ page. """ @@ -10366,6 +10367,7 @@ class UploadSessionAppendArg(bb.Struct): :ivar UploadSessionAppendArg.content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an error will be returned. + Optional, but recommended to avoid committing data corrupted in transit. For more information see our `Content hash `_ page. """ @@ -10412,10 +10414,10 @@ class UploadSessionAppendBatchArg(bb.Struct): :ivar UploadSessionAppendBatchArg.entries: Append information for each file in the batch. :ivar UploadSessionAppendBatchArg.content_hash: - A hash of the entire request body which is all the concatenated pieces - of file content that were uploaded in this call. If provided and the - uploaded content does not match this hash, an error will be returned. - For more information see our `Content hash + A single hash of all the concatenated file contents uploaded in this + call. If provided and the uploaded content does not match this hash, an + error will be returned. Optional, but recommended to avoid committing + data corrupted in transit. For more information see our `Content hash `_ page. """ @@ -11000,6 +11002,7 @@ class UploadSessionFinishArg(bb.Struct): :ivar UploadSessionFinishArg.content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an error will be returned. + Optional, but recommended to avoid committing data corrupted in transit. For more information see our `Content hash `_ page. """ @@ -11732,6 +11735,7 @@ class UploadSessionStartArg(bb.Struct): :ivar UploadSessionStartArg.content_hash: A hash of the file content uploaded in this call. If provided and the uploaded content does not match this hash, an error will be returned. + Optional, but recommended to avoid committing data corrupted in transit. For more information see our `Content hash `_ page. """ diff --git a/spec b/spec index 6d985df..e733a51 160000 --- a/spec +++ b/spec @@ -1 +1 @@ -Subproject commit 6d985dfaf901f1a909aa5e268bcfa524b0b7966e +Subproject commit e733a5105a817d9a93e5c0f16f39d467d3e2072c