Automated Spec Update - 2026_09_10

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/AlphaUploadBuilder.java

@@ -155,7 +155,8 @@ public AlphaUploadBuilder withStrictConflict(Boolean strictConflict) {
      *
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/DbxUserFilesRequests.java

@@ -4103,10 +4103,11 @@ public UploadSessionAppendBatchUploader uploadSessionAppendBatch(List<UploadSess
      * @param entries  Append information for each file in the batch. Must
      *     contain at most 500 items, not contain a {@code null} item, and not
      *     be {@code null}.
-     * @param contentHash  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 <a
+     * @param contentHash  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 <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.
@@ -4196,7 +4197,8 @@ public UploadSessionFinishUploader uploadSessionFinish(UploadSessionCursor curso
      *     commit. Must not be {@code null}.
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/UploadArg.java

@@ -63,7 +63,8 @@ class UploadArg extends CommitInfo {
      *     the target path refers to a file with identical contents.
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.
@@ -187,8 +188,9 @@ public boolean getStrictConflict() {
 
     /**
      * 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 <a
+     * 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 <a
      * href="https://www.dropbox.com/developers/reference/content-hash">Content
      * hash</a> page.
      *
@@ -233,7 +235,9 @@ protected Builder(String path) {
          *
          * @param contentHash  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 <a
+         *     error will be returned. Optional, but recommended to avoid
+         *     committing data corrupted in transit. For more information see
+         *     our <a
          *     href="https://www.dropbox.com/developers/reference/content-hash">Content
          *     hash</a> page. Must have length of at least 64 and have length of
          *     at most 64.

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/UploadBuilder.java

@@ -154,7 +154,8 @@ public UploadBuilder withStrictConflict(Boolean strictConflict) {
      *
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/UploadSessionAppendArg.java

@@ -40,7 +40,8 @@ class UploadSessionAppendArg {
      *     anymore with the current session.
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.
@@ -105,8 +106,9 @@ public boolean getClose() {
 
     /**
      * 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 <a
+     * 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 <a
      * href="https://www.dropbox.com/developers/reference/content-hash">Content
      * hash</a> page.
      *
@@ -179,7 +181,9 @@ public Builder withClose(Boolean close) {
          *
          * @param contentHash  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 <a
+         *     error will be returned. Optional, but recommended to avoid
+         *     committing data corrupted in transit. For more information see
+         *     our <a
          *     href="https://www.dropbox.com/developers/reference/content-hash">Content
          *     hash</a> page. Must have length of at least 64 and have length of
          *     at most 64.

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/UploadSessionAppendV2Builder.java

@@ -60,7 +60,8 @@ public UploadSessionAppendV2Builder withClose(Boolean close) {
      *
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/UploadSessionFinishArg.java

@@ -37,7 +37,8 @@ public class UploadSessionFinishArg {
      *     commit. Must not be {@code null}.
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.
@@ -104,8 +105,9 @@ public CommitInfo getCommit() {
 
     /**
      * 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 <a
+     * 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 <a
      * href="https://www.dropbox.com/developers/reference/content-hash">Content
      * hash</a> page.
      *

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/UploadSessionStartArg.java

@@ -40,7 +40,8 @@ class UploadSessionStartArg {
      *     specified, default is {@link UploadSessionType#SEQUENTIAL}.
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.
@@ -97,8 +98,9 @@ public UploadSessionType getSessionType() {
 
     /**
      * 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 <a
+     * 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 <a
      * href="https://www.dropbox.com/developers/reference/content-hash">Content
      * hash</a> page.
      *
@@ -175,7 +177,9 @@ public Builder withSessionType(UploadSessionType sessionType) {
          *
          * @param contentHash  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 <a
+         *     error will be returned. Optional, but recommended to avoid
+         *     committing data corrupted in transit. For more information see
+         *     our <a
          *     href="https://www.dropbox.com/developers/reference/content-hash">Content
          *     hash</a> page. Must have length of at least 64 and have length of
          *     at most 64.

core/build/generated_stone_source/main/src/com/dropbox/core/v2/files/UploadSessionStartBuilder.java

@@ -73,7 +73,8 @@ public UploadSessionStartBuilder withSessionType(UploadSessionType sessionType)
      *
      * @param contentHash  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 <a
+     *     will be returned. Optional, but recommended to avoid committing data
+     *     corrupted in transit. For more information see our <a
      *     href="https://www.dropbox.com/developers/reference/content-hash">Content
      *     hash</a> page. Must have length of at least 64 and have length of at
      *     most 64.