Automated Spec Update - 2026_09_10

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
             <https://www.dropbox.com/developers/reference/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
             <https://www.dropbox.com/developers/reference/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
             <https://www.dropbox.com/developers/reference/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
             <https://www.dropbox.com/developers/reference/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
             <https://www.dropbox.com/developers/reference/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
             <https://www.dropbox.com/developers/reference/content-hash>`_ page.
         :type content_hash: Nullable[str]
         :rtype: :class:`dropbox.files.UploadSessionStartResult`

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
         <https://www.dropbox.com/developers/reference/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
         <https://www.dropbox.com/developers/reference/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
         <https://www.dropbox.com/developers/reference/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
         <https://www.dropbox.com/developers/reference/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
         <https://www.dropbox.com/developers/reference/content-hash>`_ page.
     """