fix: Make role parameter of update collaboration optional (box/box-openapi#557) (#1479)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "9334953", "specHash": "62fdfd1", "version": "10.0.0" }
+{ "engineHash": "9334953", "specHash": "c7acada", "version": "10.0.0" }

docs/usercollaborations.md

@@ -41,7 +41,7 @@ Returns a collaboration object.
 
 Updates a collaboration.
 Can be used to change the owner of an item, or to
-accept collaboration invites.
+accept collaboration invites. In case of accepting collaboration invite, role is not required.
 
 This operation is performed by calling function `updateCollaborationById`.
 
@@ -50,7 +50,7 @@ See the endpoint docs at
 
 <!-- sample put_collaborations_id -->
 ```
-client.getUserCollaborations().updateCollaborationById(collaborationId, new UpdateCollaborationByIdRequestBody(UpdateCollaborationByIdRequestBodyRoleField.VIEWER))
+client.getUserCollaborations().updateCollaborationById(collaborationId, new UpdateCollaborationByIdRequestBody.Builder().role(UpdateCollaborationByIdRequestBodyRoleField.VIEWER).build())
 ```
 
 ### Arguments

src/main/java/com/box/sdkgen/managers/usercollaborations/UpdateCollaborationByIdRequestBody.java

@@ -23,7 +23,7 @@ public class UpdateCollaborationByIdRequestBody extends SerializableObject {
       using =
           UpdateCollaborationByIdRequestBodyRoleField
               .UpdateCollaborationByIdRequestBodyRoleFieldSerializer.class)
-  protected final EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField> role;
+  protected EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField> role;
 
   /**
    * Set the status of a `pending` collaboration invitation, effectively accepting, or rejecting the
@@ -72,15 +72,8 @@ public class UpdateCollaborationByIdRequestBody extends SerializableObject {
   @JsonProperty("can_view_path")
   protected Boolean canViewPath;
 
-  public UpdateCollaborationByIdRequestBody(UpdateCollaborationByIdRequestBodyRoleField role) {
+  public UpdateCollaborationByIdRequestBody() {
     super();
-    this.role = new EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField>(role);
-  }
-
-  public UpdateCollaborationByIdRequestBody(
-      @JsonProperty("role") EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField> role) {
-    super();
-    this.role = role;
   }
 
   protected UpdateCollaborationByIdRequestBody(Builder builder) {
@@ -151,22 +144,22 @@ public String toString() {
 
   public static class Builder extends NullableFieldTracker {
 
-    protected final EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField> role;
+    protected EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField> role;
 
     protected EnumWrapper<UpdateCollaborationByIdRequestBodyStatusField> status;
 
     protected OffsetDateTime expiresAt;
 
     protected Boolean canViewPath;
 
-    public Builder(UpdateCollaborationByIdRequestBodyRoleField role) {
-      super();
+    public Builder role(UpdateCollaborationByIdRequestBodyRoleField role) {
       this.role = new EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField>(role);
+      return this;
     }
 
-    public Builder(EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField> role) {
-      super();
+    public Builder role(EnumWrapper<UpdateCollaborationByIdRequestBodyRoleField> role) {
       this.role = role;
+      return this;
     }
 
     public Builder status(UpdateCollaborationByIdRequestBodyStatusField status) {

src/main/java/com/box/sdkgen/managers/usercollaborations/UserCollaborationsManager.java

@@ -98,7 +98,20 @@ public Collaboration getCollaborationById(
 
   /**
    * Updates a collaboration. Can be used to change the owner of an item, or to accept collaboration
-   * invites.
+   * invites. In case of accepting collaboration invite, role is not required.
+   *
+   * @param collaborationId The ID of the collaboration. Example: "1234"
+   */
+  public Collaboration updateCollaborationById(String collaborationId) {
+    return updateCollaborationById(
+        collaborationId,
+        new UpdateCollaborationByIdRequestBody(),
+        new UpdateCollaborationByIdHeaders());
+  }
+
+  /**
+   * Updates a collaboration. Can be used to change the owner of an item, or to accept collaboration
+   * invites. In case of accepting collaboration invite, role is not required.
    *
    * @param collaborationId The ID of the collaboration. Example: "1234"
    * @param requestBody Request body of updateCollaborationById method
@@ -111,7 +124,20 @@ public Collaboration updateCollaborationById(
 
   /**
    * Updates a collaboration. Can be used to change the owner of an item, or to accept collaboration
-   * invites.
+   * invites. In case of accepting collaboration invite, role is not required.
+   *
+   * @param collaborationId The ID of the collaboration. Example: "1234"
+   * @param headers Headers of updateCollaborationById method
+   */
+  public Collaboration updateCollaborationById(
+      String collaborationId, UpdateCollaborationByIdHeaders headers) {
+    return updateCollaborationById(
+        collaborationId, new UpdateCollaborationByIdRequestBody(), headers);
+  }
+
+  /**
+   * Updates a collaboration. Can be used to change the owner of an item, or to accept collaboration
+   * invites. In case of accepting collaboration invite, role is not required.
    *
    * @param collaborationId The ID of the collaboration. Example: "1234"
    * @param requestBody Request body of updateCollaborationById method

src/test/java/com/box/sdkgen/usercollaborations/UserCollaborationsITest.java

@@ -66,8 +66,9 @@ public void testUserCollaborations() {
             .getUserCollaborations()
             .updateCollaborationById(
                 collaborationId,
-                new UpdateCollaborationByIdRequestBody(
-                    UpdateCollaborationByIdRequestBodyRoleField.VIEWER));
+                new UpdateCollaborationByIdRequestBody.Builder()
+                    .role(UpdateCollaborationByIdRequestBodyRoleField.VIEWER)
+                    .build());
     assert convertToString(updatedCollaboration.getRole()).equals("viewer");
     client.getUserCollaborations().deleteCollaborationById(collaborationId);
     assertThrows(
@@ -110,8 +111,9 @@ public void testConvertingUserCollaborationToOwnership() {
             .getUserCollaborations()
             .updateCollaborationById(
                 collaboration.getId(),
-                new UpdateCollaborationByIdRequestBody(
-                    UpdateCollaborationByIdRequestBodyRoleField.OWNER));
+                new UpdateCollaborationByIdRequestBody.Builder()
+                    .role(UpdateCollaborationByIdRequestBodyRoleField.OWNER)
+                    .build());
     assert ownerCollaboration == null;
     Collaborations folderCollaborations =
         client.getListCollaborations().getFolderCollaborations(folder.getId());
@@ -155,8 +157,9 @@ public void testExternalUserCollaborations() {
             .getUserCollaborations()
             .updateCollaborationById(
                 collaborationId,
-                new UpdateCollaborationByIdRequestBody(
-                    UpdateCollaborationByIdRequestBodyRoleField.VIEWER));
+                new UpdateCollaborationByIdRequestBody.Builder()
+                    .role(UpdateCollaborationByIdRequestBodyRoleField.VIEWER)
+                    .build());
     assert convertToString(updatedCollaboration.getRole()).equals("viewer");
     client.getUserCollaborations().deleteCollaborationById(collaborationId);
     assertThrows(