feat: Support common union fields and implicit union conversion (box/box-codegen#758) (#361)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "fe48a56", "specHash": "8402463", "version": "0.7.0" }
+{ "engineHash": "ba4dd3b", "specHash": "8402463", "version": "0.7.0" }

docs/ai.md

@@ -18,7 +18,7 @@ See the endpoint docs at
 
 <!-- sample post_ai_ask -->
 ```
-client.getAi().createAiAsk(new AiAsk(AiAskModeField.SINGLE_ITEM_QA, "which direction sun rises", Arrays.asList(new AiItemAsk.Builder(fileToAsk.getId(), AiItemAskTypeField.FILE).content("Sun rises in the East").build())))
+client.getAi().createAiAsk(new AiAsk.Builder(AiAskModeField.SINGLE_ITEM_QA, "which direction sun rises", Arrays.asList(new AiItemAsk.Builder(fileToAsk.getId(), AiItemAskTypeField.FILE).content("Sun rises in the East").build())).aiAgent(aiAskAgentConfig).build())
 ```
 
 ### Arguments
@@ -47,7 +47,7 @@ See the endpoint docs at
 
 <!-- sample post_ai_text_gen -->
 ```
-client.getAi().createAiTextGen(new AiTextGen.Builder("Parapharse the document.s", Arrays.asList(new AiTextGenItemsField.Builder(fileToAsk.getId()).type(AiTextGenItemsTypeField.FILE).content("The Earth goes around the sun. Sun rises in the East in the morning.").build())).dialogueHistory(Arrays.asList(new AiDialogueHistory.Builder().prompt("What does the earth go around?").answer("The sun").createdAt(dateTimeFromString("2021-01-01T00:00:00Z")).build(), new AiDialogueHistory.Builder().prompt("On Earth, where does the sun rise?").answer("East").createdAt(dateTimeFromString("2021-01-01T00:00:00Z")).build())).build())
+client.getAi().createAiTextGen(new AiTextGen.Builder("Parapharse the document.s", Arrays.asList(new AiTextGenItemsField.Builder(fileToAsk.getId()).type(AiTextGenItemsTypeField.FILE).content("The Earth goes around the sun. Sun rises in the East in the morning.").build())).dialogueHistory(Arrays.asList(new AiDialogueHistory.Builder().prompt("What does the earth go around?").answer("The sun").createdAt(dateTimeFromString("2021-01-01T00:00:00Z")).build(), new AiDialogueHistory.Builder().prompt("On Earth, where does the sun rise?").answer("East").createdAt(dateTimeFromString("2021-01-01T00:00:00Z")).build())).aiAgent(aiTextGenAgentConfig).build())
 ```
 
 ### Arguments
@@ -113,7 +113,7 @@ See the endpoint docs at
 
 <!-- sample post_ai_extract -->
 ```
-client.getAi().createAiExtract(new AiExtract("firstName, lastName, location, yearOfBirth, company", Arrays.asList(new AiItemBase(file.getId()))))
+client.getAi().createAiExtract(new AiExtract.Builder("firstName, lastName, location, yearOfBirth, company", Arrays.asList(new AiItemBase(file.getId()))).aiAgent(agentIgnoringOverridingEmbeddingsModel).build())
 ```
 
 ### Arguments
@@ -146,7 +146,7 @@ See the endpoint docs at
 
 <!-- sample post_ai_extract_structured -->
 ```
-client.getAi().createAiExtractStructured(new AiExtractStructured.Builder(Arrays.asList(new AiItemBase(file.getId()))).fields(Arrays.asList(new AiExtractStructuredFieldsField.Builder("firstName").description("Person first name").displayName("First name").prompt("What is the your first name?").type("string").build(), new AiExtractStructuredFieldsField.Builder("lastName").description("Person last name").displayName("Last name").prompt("What is the your last name?").type("string").build(), new AiExtractStructuredFieldsField.Builder("dateOfBirth").description("Person date of birth").displayName("Birth date").prompt("What is the date of your birth?").type("date").build(), new AiExtractStructuredFieldsField.Builder("age").description("Person age").displayName("Age").prompt("How old are you?").type("float").build(), new AiExtractStructuredFieldsField.Builder("hobby").description("Person hobby").displayName("Hobby").prompt("What is your hobby?").type("multiSelect").options(Arrays.asList(new AiExtractStructuredFieldsOptionsField("guitar"), new AiExtractStructuredFieldsOptionsField("books"))).build())).build())
+client.getAi().createAiExtractStructured(new AiExtractStructured.Builder(Arrays.asList(new AiItemBase(file.getId()))).fields(Arrays.asList(new AiExtractStructuredFieldsField.Builder("firstName").description("Person first name").displayName("First name").prompt("What is the your first name?").type("string").build(), new AiExtractStructuredFieldsField.Builder("lastName").description("Person last name").displayName("Last name").prompt("What is the your last name?").type("string").build(), new AiExtractStructuredFieldsField.Builder("dateOfBirth").description("Person date of birth").displayName("Birth date").prompt("What is the date of your birth?").type("date").build(), new AiExtractStructuredFieldsField.Builder("age").description("Person age").displayName("Age").prompt("How old are you?").type("float").build(), new AiExtractStructuredFieldsField.Builder("hobby").description("Person hobby").displayName("Hobby").prompt("What is your hobby?").type("multiSelect").options(Arrays.asList(new AiExtractStructuredFieldsOptionsField("guitar"), new AiExtractStructuredFieldsOptionsField("books"))).build())).aiAgent(agentIgnoringOverridingEmbeddingsModel).build())
 ```
 
 ### Arguments

docs/filemetadata.md

@@ -90,7 +90,7 @@ See the endpoint docs at
 
 <!-- sample post_files_id_metadata_id_id -->
 ```
-client.getFileMetadata().createFileMetadataById(file.getId(), CreateFileMetadataByIdScope.GLOBAL, "properties", mapOf(entryOf("abc", "xyz")))
+client.getFileMetadata().createFileMetadataById(file.getId(), CreateFileMetadataByIdScope.ENTERPRISE, templateKey, mapOf(entryOf("name", "John"), entryOf("age", 23), entryOf("birthDate", "2001-01-03T02:20:50.520Z"), entryOf("countryCode", "US"), entryOf("sports", Arrays.asList("basketball", "tennis"))))
 ```
 
 ### Arguments
@@ -131,7 +131,10 @@ This operation is performed by calling function `updateFileMetadataById`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/put-files-id-metadata-id-id/).
 
-*Currently we don't have an example for calling `updateFileMetadataById` in integration tests*
+<!-- sample put_files_id_metadata_id_id -->
+```
+client.getFileMetadata().updateFileMetadataById(file.getId(), UpdateFileMetadataByIdScope.ENTERPRISE, templateKey, Arrays.asList(new UpdateFileMetadataByIdRequestBody.Builder().op(UpdateFileMetadataByIdRequestBodyOpField.REPLACE).path("/name").value("Jack").build(), new UpdateFileMetadataByIdRequestBody.Builder().op(UpdateFileMetadataByIdRequestBodyOpField.REPLACE).path("/age").value(24L).build(), new UpdateFileMetadataByIdRequestBody.Builder().op(UpdateFileMetadataByIdRequestBodyOpField.REPLACE).path("/birthDate").value("2000-01-03T02:20:50.520Z").build(), new UpdateFileMetadataByIdRequestBody.Builder().op(UpdateFileMetadataByIdRequestBodyOpField.REPLACE).path("/countryCode").value("CA").build(), new UpdateFileMetadataByIdRequestBody.Builder().op(UpdateFileMetadataByIdRequestBodyOpField.REPLACE).path("/sports").value(Arrays.asList("football")).build()))
+```
 
 ### Arguments
 
@@ -166,7 +169,7 @@ See the endpoint docs at
 
 <!-- sample delete_files_id_metadata_id_id -->
 ```
-client.getFileMetadata().deleteFileMetadataById(file.getId(), DeleteFileMetadataByIdScope.GLOBAL, "properties")
+client.getFileMetadata().deleteFileMetadataById(file.getId(), DeleteFileMetadataByIdScope.ENTERPRISE, templateKey)
 ```
 
 ### Arguments

docs/foldermetadata.md

@@ -95,7 +95,7 @@ See the endpoint docs at
 
 <!-- sample post_folders_id_metadata_id_id -->
 ```
-client.getFolderMetadata().createFolderMetadataById(folder.getId(), CreateFolderMetadataByIdScope.GLOBAL, "properties", mapOf(entryOf("abc", "xyz")))
+client.getFolderMetadata().createFolderMetadataById(folder.getId(), CreateFolderMetadataByIdScope.ENTERPRISE, templateKey, mapOf(entryOf("name", "John"), entryOf("age", 23), entryOf("birthDate", "2001-01-03T02:20:50.520Z"), entryOf("countryCode", "US"), entryOf("sports", Arrays.asList("basketball", "tennis"))))
 ```
 
 ### Arguments
@@ -136,7 +136,10 @@ This operation is performed by calling function `updateFolderMetadataById`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/put-folders-id-metadata-id-id/).
 
-*Currently we don't have an example for calling `updateFolderMetadataById` in integration tests*
+<!-- sample put_folders_id_metadata_id_id -->
+```
+client.getFolderMetadata().updateFolderMetadataById(folder.getId(), UpdateFolderMetadataByIdScope.ENTERPRISE, templateKey, Arrays.asList(new UpdateFolderMetadataByIdRequestBody.Builder().op(UpdateFolderMetadataByIdRequestBodyOpField.REPLACE).path("/name").value("Jack").build(), new UpdateFolderMetadataByIdRequestBody.Builder().op(UpdateFolderMetadataByIdRequestBodyOpField.REPLACE).path("/age").value(24L).build(), new UpdateFolderMetadataByIdRequestBody.Builder().op(UpdateFolderMetadataByIdRequestBodyOpField.REPLACE).path("/birthDate").value("2000-01-03T02:20:50.520Z").build(), new UpdateFolderMetadataByIdRequestBody.Builder().op(UpdateFolderMetadataByIdRequestBodyOpField.REPLACE).path("/countryCode").value("CA").build(), new UpdateFolderMetadataByIdRequestBody.Builder().op(UpdateFolderMetadataByIdRequestBodyOpField.REPLACE).path("/sports").value(Arrays.asList("football")).build()))
+```
 
 ### Arguments
 
@@ -171,7 +174,7 @@ See the endpoint docs at
 
 <!-- sample delete_folders_id_metadata_id_id -->
 ```
-client.getFolderMetadata().deleteFolderMetadataById(folder.getId(), DeleteFolderMetadataByIdScope.GLOBAL, "properties")
+client.getFolderMetadata().deleteFolderMetadataById(folder.getId(), DeleteFolderMetadataByIdScope.ENTERPRISE, templateKey)
 ```
 
 ### Arguments

docs/search.md

@@ -48,7 +48,10 @@ This operation is performed by calling function `searchForContent`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/get-search/).
 
-*Currently we don't have an example for calling `searchForContent` in integration tests*
+<!-- sample get_search -->
+```
+client.getSearch().searchForContent(new SearchForContentQueryParams.Builder().ancestorFolderIds(Arrays.asList("0")).mdfilters(Arrays.asList(new MetadataFilter.Builder().scope(MetadataFilterScopeField.ENTERPRISE).templateKey(templateKey).filters(searchFilters).build())).build())
+```
 
 ### Arguments
 

docs/shieldlists.md

@@ -16,7 +16,10 @@ This operation is performed by calling function `getShieldListsV2025R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2025.0/get-shield-lists/).
 
-*Currently we don't have an example for calling `getShieldListsV2025R0` in integration tests*
+<!-- sample get_shield_lists_v2025.0 -->
+```
+client.getShieldLists().getShieldListsV2025R0()
+```
 
 ### Arguments
 
@@ -40,7 +43,10 @@ This operation is performed by calling function `createShieldListV2025R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2025.0/post-shield-lists/).
 
-*Currently we don't have an example for calling `createShieldListV2025R0` in integration tests*
+<!-- sample post_shield_lists_v2025.0 -->
+```
+client.getShieldLists().createShieldListV2025R0(new ShieldListsCreateV2025R0.Builder(shieldListCountryName, new ShieldListContentCountryV2025R0.Builder(Arrays.asList("US", "PL")).type(ShieldListContentCountryV2025R0TypeField.COUNTRY).build()).description("A list of things that are shielded").build())
+```
 
 ### Arguments
 
@@ -66,7 +72,10 @@ This operation is performed by calling function `getShieldListByIdV2025R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2025.0/get-shield-lists-id/).
 
-*Currently we don't have an example for calling `getShieldListByIdV2025R0` in integration tests*
+<!-- sample get_shield_lists_id_v2025.0 -->
+```
+client.getShieldLists().getShieldListByIdV2025R0(shieldListCountry.getId())
+```
 
 ### Arguments
 
@@ -92,7 +101,10 @@ This operation is performed by calling function `deleteShieldListByIdV2025R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2025.0/delete-shield-lists-id/).
 
-*Currently we don't have an example for calling `deleteShieldListByIdV2025R0` in integration tests*
+<!-- sample delete_shield_lists_id_v2025.0 -->
+```
+client.getShieldLists().deleteShieldListByIdV2025R0(shieldListCountry.getId())
+```
 
 ### Arguments
 
@@ -118,7 +130,10 @@ This operation is performed by calling function `updateShieldListByIdV2025R0`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/v2025.0/put-shield-lists-id/).
 
-*Currently we don't have an example for calling `updateShieldListByIdV2025R0` in integration tests*
+<!-- sample put_shield_lists_id_v2025.0 -->
+```
+client.getShieldLists().updateShieldListByIdV2025R0(shieldListCountry.getId(), new ShieldListsUpdateV2025R0.Builder(shieldListCountryName, new ShieldListContentCountryV2025R0.Builder(Arrays.asList("US")).type(ShieldListContentCountryV2025R0TypeField.COUNTRY).build()).description("Updated description").build())
+```
 
 ### Arguments
 

docs/skills.md

@@ -16,7 +16,10 @@ This operation is performed by calling function `getBoxSkillCardsOnFile`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/get-files-id-metadata-global-boxSkillsCards/).
 
-*Currently we don't have an example for calling `getBoxSkillCardsOnFile` in integration tests*
+<!-- sample get_files_id_metadata_global_boxSkillsCards -->
+```
+client.getSkills().getBoxSkillCardsOnFile(file.getId())
+```
 
 ### Arguments
 
@@ -45,7 +48,10 @@ This operation is performed by calling function `createBoxSkillCardsOnFile`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/post-files-id-metadata-global-boxSkillsCards/).
 
-*Currently we don't have an example for calling `createBoxSkillCardsOnFile` in integration tests*
+<!-- sample post_files_id_metadata_global_boxSkillsCards -->
+```
+client.getSkills().createBoxSkillCardsOnFile(file.getId(), new CreateBoxSkillCardsOnFileRequestBody(cardsToCreate))
+```
 
 ### Arguments
 
@@ -74,7 +80,10 @@ This operation is performed by calling function `updateBoxSkillCardsOnFile`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/put-files-id-metadata-global-boxSkillsCards/).
 
-*Currently we don't have an example for calling `updateBoxSkillCardsOnFile` in integration tests*
+<!-- sample put_files_id_metadata_global_boxSkillsCards -->
+```
+client.getSkills().updateBoxSkillCardsOnFile(file.getId(), Arrays.asList(new UpdateBoxSkillCardsOnFileRequestBody.Builder().op(UpdateBoxSkillCardsOnFileRequestBodyOpField.REPLACE).path("/cards/0").value(cardToUpdate).build()))
+```
 
 ### Arguments
 
@@ -103,7 +112,10 @@ This operation is performed by calling function `deleteBoxSkillCardsFromFile`.
 See the endpoint docs at
 [API Reference](https://developer.box.com/reference/delete-files-id-metadata-global-boxSkillsCards/).
 
-*Currently we don't have an example for calling `deleteBoxSkillCardsFromFile` in integration tests*
+<!-- sample delete_files_id_metadata_global_boxSkillsCards -->
+```
+client.getSkills().deleteBoxSkillCardsFromFile(file.getId())
+```
 
 ### Arguments
 

src/main/java/com/box/sdkgen/managers/ai/GetAiAgentDefaultConfigQueryParams.java

@@ -10,15 +10,15 @@ public class GetAiAgentDefaultConfigQueryParams {
 
   public String model;
 
+  public GetAiAgentDefaultConfigQueryParams(GetAiAgentDefaultConfigQueryParamsModeField mode) {
+    this.mode = new EnumWrapper<GetAiAgentDefaultConfigQueryParamsModeField>(mode);
+  }
+
   public GetAiAgentDefaultConfigQueryParams(
       EnumWrapper<GetAiAgentDefaultConfigQueryParamsModeField> mode) {
     this.mode = mode;
   }
 
-  public GetAiAgentDefaultConfigQueryParams(GetAiAgentDefaultConfigQueryParamsModeField mode) {
-    this.mode = new EnumWrapper<GetAiAgentDefaultConfigQueryParamsModeField>(mode);
-  }
-
   protected GetAiAgentDefaultConfigQueryParams(Builder builder) {
     this.mode = builder.mode;
     this.language = builder.language;
@@ -45,14 +45,14 @@ public static class Builder {
 
     protected String model;
 
-    public Builder(EnumWrapper<GetAiAgentDefaultConfigQueryParamsModeField> mode) {
-      this.mode = mode;
-    }
-
     public Builder(GetAiAgentDefaultConfigQueryParamsModeField mode) {
       this.mode = new EnumWrapper<GetAiAgentDefaultConfigQueryParamsModeField>(mode);
     }
 
+    public Builder(EnumWrapper<GetAiAgentDefaultConfigQueryParamsModeField> mode) {
+      this.mode = mode;
+    }
+
     public Builder language(String language) {
       this.language = language;
       return this;

src/main/java/com/box/sdkgen/managers/authorization/AuthorizeUserQueryParams.java

@@ -15,14 +15,14 @@ public class AuthorizeUserQueryParams {
   public String scope;
 
   public AuthorizeUserQueryParams(
-      EnumWrapper<AuthorizeUserQueryParamsResponseTypeField> responseType, String clientId) {
-    this.responseType = responseType;
+      AuthorizeUserQueryParamsResponseTypeField responseType, String clientId) {
+    this.responseType = new EnumWrapper<AuthorizeUserQueryParamsResponseTypeField>(responseType);
     this.clientId = clientId;
   }
 
   public AuthorizeUserQueryParams(
-      AuthorizeUserQueryParamsResponseTypeField responseType, String clientId) {
-    this.responseType = new EnumWrapper<AuthorizeUserQueryParamsResponseTypeField>(responseType);
+      EnumWrapper<AuthorizeUserQueryParamsResponseTypeField> responseType, String clientId) {
+    this.responseType = responseType;
     this.clientId = clientId;
   }
 
@@ -66,14 +66,14 @@ public static class Builder {
 
     protected String scope;
 
-    public Builder(
-        EnumWrapper<AuthorizeUserQueryParamsResponseTypeField> responseType, String clientId) {
-      this.responseType = responseType;
+    public Builder(AuthorizeUserQueryParamsResponseTypeField responseType, String clientId) {
+      this.responseType = new EnumWrapper<AuthorizeUserQueryParamsResponseTypeField>(responseType);
       this.clientId = clientId;
     }
 
-    public Builder(AuthorizeUserQueryParamsResponseTypeField responseType, String clientId) {
-      this.responseType = new EnumWrapper<AuthorizeUserQueryParamsResponseTypeField>(responseType);
+    public Builder(
+        EnumWrapper<AuthorizeUserQueryParamsResponseTypeField> responseType, String clientId) {
+      this.responseType = responseType;
       this.clientId = clientId;
     }
 

src/main/java/com/box/sdkgen/managers/collaborationallowlistentries/CreateCollaborationWhitelistEntryRequestBody.java

@@ -24,20 +24,20 @@ public class CreateCollaborationWhitelistEntryRequestBody extends SerializableOb
   protected final EnumWrapper<CreateCollaborationWhitelistEntryRequestBodyDirectionField> direction;
 
   public CreateCollaborationWhitelistEntryRequestBody(
-      @JsonProperty("domain") String domain,
-      @JsonProperty("direction")
-          EnumWrapper<CreateCollaborationWhitelistEntryRequestBodyDirectionField> direction) {
+      String domain, CreateCollaborationWhitelistEntryRequestBodyDirectionField direction) {
     super();
     this.domain = domain;
-    this.direction = direction;
+    this.direction =
+        new EnumWrapper<CreateCollaborationWhitelistEntryRequestBodyDirectionField>(direction);
   }
 
   public CreateCollaborationWhitelistEntryRequestBody(
-      String domain, CreateCollaborationWhitelistEntryRequestBodyDirectionField direction) {
+      @JsonProperty("domain") String domain,
+      @JsonProperty("direction")
+          EnumWrapper<CreateCollaborationWhitelistEntryRequestBodyDirectionField> direction) {
     super();
     this.domain = domain;
-    this.direction =
-        new EnumWrapper<CreateCollaborationWhitelistEntryRequestBodyDirectionField>(direction);
+    this.direction = direction;
   }
 
   public String getDomain() {