feat(boxsdkgen): add metadata_template target and filter_fields to legal hold assignments (box/box-openapi#625)

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "976bbb9", "specHash": "a0e8038", "version": "5.19.0" }
+{ "engineHash": "88c0ae7", "specHash": "74452eb", "version": "5.19.0" }

docs/sdkgen/documentsplit.md

@@ -26,7 +26,10 @@ This operation is performed by calling function `createDocumentSplitV2026R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2026.0/post-document-splits/).
 
-*Currently we don't have an example for calling `createDocumentSplitV2026R0` in integration tests*
+<!-- sample post_document_splits_v2026.0 -->
+```
+client.getDocumentSplit().createDocumentSplitV2026R0(new DocumentSplitCreateRequestV2026R0.Builder(file.getId(), folder.getId(), DocumentSplitCreateRequestV2026R0InputSourceField.API, new DocumentSplitCreateRequestManualV2026R0.Builder(Arrays.asList(new DocumentSplitPageRangeV2026R0(1, 1))).splitType(DocumentSplitCreateRequestManualV2026R0SplitTypeField.MANUAL).build()).externalId(externalId).build())
+```
 
 ### Arguments
 
@@ -54,7 +57,10 @@ This operation is performed by calling function `getDocumentSplitsV2026R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2026.0/get-document-splits/).
 
-*Currently we don't have an example for calling `getDocumentSplitsV2026R0` in integration tests*
+<!-- sample get_document_splits_v2026.0 -->
+```
+client.getDocumentSplit().getDocumentSplitsV2026R0(new GetDocumentSplitsV2026R0QueryParams.Builder().limit(10L).build())
+```
 
 ### Arguments
 
@@ -82,7 +88,10 @@ This operation is performed by calling function `getDocumentSplitByIdV2026R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2026.0/get-document-splits-id/).
 
-*Currently we don't have an example for calling `getDocumentSplitByIdV2026R0` in integration tests*
+<!-- sample get_document_splits_id_v2026.0 -->
+```
+client.getDocumentSplit().getDocumentSplitByIdV2026R0(createdDocumentSplit.getId())
+```
 
 ### Arguments
 

docs/sdkgen/legalholdpolicyassignments.md

@@ -38,7 +38,7 @@ Returns a list of legal hold policy assignments.
 
 ## Assign legal hold policy
 
-Assign a legal hold to an item type of: file, file version, folder, user, ownership, or interactions.
+Assign a legal hold to an item type of: file, file version, folder, user, ownership, interactions, or metadata template.
 
 This operation is performed by calling function `createLegalHoldPolicyAssignment`.
 

src/intTest/java/com/box/sdkgen/documentsplit/DocumentSplitITest.java

@@ -0,0 +1,75 @@
+package com.box.sdkgen.documentsplit;
+
+import static com.box.sdkgen.commons.CommonsManager.createNewFolder;
+import static com.box.sdkgen.commons.CommonsManager.getDefaultClient;
+import static com.box.sdkgen.commons.CommonsManager.uploadNewFile;
+import static com.box.sdkgen.internal.utils.UtilsManager.convertToString;
+import static com.box.sdkgen.internal.utils.UtilsManager.getUuid;
+
+import com.box.sdkgen.client.BoxClient;
+import com.box.sdkgen.managers.documentsplit.GetDocumentSplitsV2026R0QueryParams;
+import com.box.sdkgen.managers.folders.DeleteFolderByIdQueryParams;
+import com.box.sdkgen.schemas.filefull.FileFull;
+import com.box.sdkgen.schemas.folderfull.FolderFull;
+import com.box.sdkgen.schemas.v2026r0.documentsplitcreaterequestmanualv2026r0.DocumentSplitCreateRequestManualV2026R0;
+import com.box.sdkgen.schemas.v2026r0.documentsplitcreaterequestmanualv2026r0.DocumentSplitCreateRequestManualV2026R0SplitTypeField;
+import com.box.sdkgen.schemas.v2026r0.documentsplitcreaterequestv2026r0.DocumentSplitCreateRequestV2026R0;
+import com.box.sdkgen.schemas.v2026r0.documentsplitcreaterequestv2026r0.DocumentSplitCreateRequestV2026R0InputSourceField;
+import com.box.sdkgen.schemas.v2026r0.documentsplitcreateresponsev2026r0.DocumentSplitCreateResponseV2026R0;
+import com.box.sdkgen.schemas.v2026r0.documentsplitpagerangev2026r0.DocumentSplitPageRangeV2026R0;
+import com.box.sdkgen.schemas.v2026r0.documentsplitsv2026r0.DocumentSplitsV2026R0;
+import com.box.sdkgen.schemas.v2026r0.documentsplitv2026r0.DocumentSplitV2026R0;
+import java.util.Arrays;
+import org.junit.jupiter.api.Test;
+
+public class DocumentSplitITest {
+
+  private static final BoxClient client = getDefaultClient();
+
+  @Test
+  public void testCreateDocumentSplitV2026R0() {
+    FileFull file = uploadNewFile();
+    FolderFull folder = createNewFolder();
+    String externalId = getUuid();
+    DocumentSplitCreateResponseV2026R0 createdDocumentSplit =
+        client
+            .getDocumentSplit()
+            .createDocumentSplitV2026R0(
+                new DocumentSplitCreateRequestV2026R0.Builder(
+                        file.getId(),
+                        folder.getId(),
+                        DocumentSplitCreateRequestV2026R0InputSourceField.API,
+                        new DocumentSplitCreateRequestManualV2026R0.Builder(
+                                Arrays.asList(new DocumentSplitPageRangeV2026R0(1, 1)))
+                            .splitType(DocumentSplitCreateRequestManualV2026R0SplitTypeField.MANUAL)
+                            .build())
+                    .externalId(externalId)
+                    .build());
+    assert !(createdDocumentSplit.getId().equals(""));
+    assert convertToString(createdDocumentSplit.getType()).equals("document_split");
+    DocumentSplitV2026R0 documentSplit =
+        client.getDocumentSplit().getDocumentSplitByIdV2026R0(createdDocumentSplit.getId());
+    assert documentSplit.getId().equals(createdDocumentSplit.getId());
+    assert convertToString(documentSplit.getType()).equals("document_split");
+    assert documentSplit.getSourceFile().getId().equals(file.getId());
+    assert documentSplit.getDestinationFolder().getId().equals(folder.getId());
+    assert convertToString(documentSplit.getInputSource()).equals("api");
+    assert !(convertToString(documentSplit.getStatus()).equals(""));
+    assert documentSplit.getExternalId().equals(externalId);
+    client
+        .getFolders()
+        .deleteFolderById(
+            folder.getId(), new DeleteFolderByIdQueryParams.Builder().recursive(true).build());
+    client.getFiles().deleteFileById(file.getId());
+  }
+
+  @Test
+  public void testGetDocumentSplitsV2026R0() {
+    DocumentSplitsV2026R0 documentSplits =
+        client
+            .getDocumentSplit()
+            .getDocumentSplitsV2026R0(
+                new GetDocumentSplitsV2026R0QueryParams.Builder().limit(10L).build());
+    assert documentSplits.getEntries().size() >= 0;
+  }
+}

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/CreateLegalHoldPolicyAssignmentRequestBody.java

@@ -1,8 +1,11 @@
 package com.box.sdkgen.managers.legalholdpolicyassignments;
 
+import com.box.sdkgen.internal.NullableFieldTracker;
 import com.box.sdkgen.internal.SerializableObject;
+import com.box.sdkgen.schemas.legalholdpolicyassignmentfilterfield.LegalHoldPolicyAssignmentFilterField;
 import com.fasterxml.jackson.annotation.JsonFilter;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import java.util.List;
 import java.util.Objects;
 
 @JsonFilter("nullablePropertyFilter")
@@ -16,6 +19,13 @@ public class CreateLegalHoldPolicyAssignmentRequestBody extends SerializableObje
   @JsonProperty("assign_to")
   protected final CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo;
 
+  /**
+   * List of metadata template field filters. Only required when `assign_to.type` is
+   * `metadata_template`.
+   */
+  @JsonProperty("filter_fields")
+  protected List<LegalHoldPolicyAssignmentFilterField> filterFields;
+
   public CreateLegalHoldPolicyAssignmentRequestBody(
       @JsonProperty("policy_id") String policyId,
       @JsonProperty("assign_to") CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo) {
@@ -24,6 +34,14 @@ public CreateLegalHoldPolicyAssignmentRequestBody(
     this.assignTo = assignTo;
   }
 
+  protected CreateLegalHoldPolicyAssignmentRequestBody(Builder builder) {
+    super();
+    this.policyId = builder.policyId;
+    this.assignTo = builder.assignTo;
+    this.filterFields = builder.filterFields;
+    markNullableFieldsAsSet(builder.getExplicitlySetNullableFields());
+  }
+
   public String getPolicyId() {
     return policyId;
   }
@@ -32,6 +50,10 @@ public CreateLegalHoldPolicyAssignmentRequestBodyAssignToField getAssignTo() {
     return assignTo;
   }
 
+  public List<LegalHoldPolicyAssignmentFilterField> getFilterFields() {
+    return filterFields;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -42,12 +64,14 @@ public boolean equals(Object o) {
     }
     CreateLegalHoldPolicyAssignmentRequestBody casted =
         (CreateLegalHoldPolicyAssignmentRequestBody) o;
-    return Objects.equals(policyId, casted.policyId) && Objects.equals(assignTo, casted.assignTo);
+    return Objects.equals(policyId, casted.policyId)
+        && Objects.equals(assignTo, casted.assignTo)
+        && Objects.equals(filterFields, casted.filterFields);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(policyId, assignTo);
+    return Objects.hash(policyId, assignTo, filterFields);
   }
 
   @Override
@@ -60,6 +84,35 @@ public String toString() {
         + "assignTo='"
         + assignTo
         + '\''
+        + ", "
+        + "filterFields='"
+        + filterFields
+        + '\''
         + "}";
   }
+
+  public static class Builder extends NullableFieldTracker {
+
+    protected final String policyId;
+
+    protected final CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo;
+
+    protected List<LegalHoldPolicyAssignmentFilterField> filterFields;
+
+    public Builder(
+        String policyId, CreateLegalHoldPolicyAssignmentRequestBodyAssignToField assignTo) {
+      super();
+      this.policyId = policyId;
+      this.assignTo = assignTo;
+    }
+
+    public Builder filterFields(List<LegalHoldPolicyAssignmentFilterField> filterFields) {
+      this.filterFields = filterFields;
+      return this;
+    }
+
+    public CreateLegalHoldPolicyAssignmentRequestBody build() {
+      return new CreateLegalHoldPolicyAssignmentRequestBody(this);
+    }
+  }
 }

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/CreateLegalHoldPolicyAssignmentRequestBodyAssignToTypeField.java

@@ -18,7 +18,8 @@ public enum CreateLegalHoldPolicyAssignmentRequestBodyAssignToTypeField implemen
   FOLDER("folder"),
   USER("user"),
   OWNERSHIP("ownership"),
-  INTERACTIONS("interactions");
+  INTERACTIONS("interactions"),
+  METADATA_TEMPLATE("metadata_template");
 
   private final String value;
 

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/GetLegalHoldPolicyAssignmentsQueryParamsAssignToTypeField.java

@@ -18,7 +18,8 @@ public enum GetLegalHoldPolicyAssignmentsQueryParamsAssignToTypeField implements
   FOLDER("folder"),
   USER("user"),
   OWNERSHIP("ownership"),
-  INTERACTIONS("interactions");
+  INTERACTIONS("interactions"),
+  METADATA_TEMPLATE("metadata_template");
 
   private final String value;
 

src/main/java/com/box/sdkgen/managers/legalholdpolicyassignments/LegalHoldPolicyAssignmentsManager.java

@@ -81,8 +81,8 @@ public LegalHoldPolicyAssignments getLegalHoldPolicyAssignments(
   }
 
   /**
-   * Assign a legal hold to an item type of: file, file version, folder, user, ownership, or
-   * interactions.
+   * Assign a legal hold to an item type of: file, file version, folder, user, ownership,
+   * interactions, or metadata template.
    *
    * @param requestBody Request body of createLegalHoldPolicyAssignment method
    */
@@ -93,8 +93,8 @@ public LegalHoldPolicyAssignment createLegalHoldPolicyAssignment(
   }
 
   /**
-   * Assign a legal hold to an item type of: file, file version, folder, user, ownership, or
-   * interactions.
+   * Assign a legal hold to an item type of: file, file version, folder, user, ownership,
+   * interactions, or metadata template.
    *
    * @param requestBody Request body of createLegalHoldPolicyAssignment method
    * @param headers Headers of createLegalHoldPolicyAssignment method

src/main/java/com/box/sdkgen/schemas/legalholdpolicy/LegalHoldPolicyAssignmentCountsField.java

@@ -28,6 +28,10 @@ public class LegalHoldPolicyAssignmentCountsField extends SerializableObject {
   /** The number of users this policy is applied to with the `interactions` type assignment. */
   protected Long interactions;
 
+  /** The number of metadata templates this policy is applied to. */
+  @JsonProperty("metadata_template")
+  protected Long metadataTemplate;
+
   public LegalHoldPolicyAssignmentCountsField() {
     super();
   }
@@ -40,6 +44,7 @@ protected LegalHoldPolicyAssignmentCountsField(Builder builder) {
     this.fileVersion = builder.fileVersion;
     this.ownership = builder.ownership;
     this.interactions = builder.interactions;
+    this.metadataTemplate = builder.metadataTemplate;
     markNullableFieldsAsSet(builder.getExplicitlySetNullableFields());
   }
 
@@ -67,6 +72,10 @@ public Long getInteractions() {
     return interactions;
   }
 
+  public Long getMetadataTemplate() {
+    return metadataTemplate;
+  }
+
   @Override
   public boolean equals(Object o) {
     if (this == o) {
@@ -81,12 +90,13 @@ public boolean equals(Object o) {
         && Objects.equals(file, casted.file)
         && Objects.equals(fileVersion, casted.fileVersion)
         && Objects.equals(ownership, casted.ownership)
-        && Objects.equals(interactions, casted.interactions);
+        && Objects.equals(interactions, casted.interactions)
+        && Objects.equals(metadataTemplate, casted.metadataTemplate);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(user, folder, file, fileVersion, ownership, interactions);
+    return Objects.hash(user, folder, file, fileVersion, ownership, interactions, metadataTemplate);
   }
 
   @Override
@@ -115,6 +125,10 @@ public String toString() {
         + "interactions='"
         + interactions
         + '\''
+        + ", "
+        + "metadataTemplate='"
+        + metadataTemplate
+        + '\''
         + "}";
   }
 
@@ -132,6 +146,8 @@ public static class Builder extends NullableFieldTracker {
 
     protected Long interactions;
 
+    protected Long metadataTemplate;
+
     public Builder user(Long user) {
       this.user = user;
       return this;
@@ -162,6 +178,11 @@ public Builder interactions(Long interactions) {
       return this;
     }
 
+    public Builder metadataTemplate(Long metadataTemplate) {
+      this.metadataTemplate = metadataTemplate;
+      return this;
+    }
+
     public LegalHoldPolicyAssignmentCountsField build() {
       return new LegalHoldPolicyAssignmentCountsField(this);
     }

src/main/java/com/box/sdkgen/schemas/legalholdpolicyassigneditem/LegalHoldPolicyAssignedItemTypeField.java

@@ -18,7 +18,8 @@ public enum LegalHoldPolicyAssignedItemTypeField implements Valuable {
   FOLDER("folder"),
   USER("user"),
   OWNERSHIP("ownership"),
-  INTERACTIONS("interactions");
+  INTERACTIONS("interactions"),
+  METADATA_TEMPLATE("metadata_template");
 
   private final String value;