feat: Hub items API (box/box-openapi#538)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "fe7a2b2", "specHash": "719cda2", "version": "0.7.0" }
+{ "engineHash": "fe7a2b2", "specHash": "7871ded", "version": "0.7.0" }

docs/README.md

@@ -37,6 +37,7 @@ the SDK are available by topic:
 * [Folderwatermarks](folderwatermarks.md)
 * [Groups](groups.md)
 * [Hubcollaborations](hubcollaborations.md)
+* [Hubitems](hubitems.md)
 * [Hubs](hubs.md)
 * [Integrationmappings](integrationmappings.md)
 * [Invites](invites.md)

docs/hubitems.md

@@ -0,0 +1,60 @@
+# HubItemsManager
+
+
+- [Get hub items](#get-hub-items)
+- [Manage hub items](#manage-hub-items)
+
+## Get hub items
+
+Retrieves all items associated with a Hub.
+
+This operation is performed by calling function `getHubItemsV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/get-hub-items/).
+
+*Currently we don't have an example for calling `getHubItemsV2025R0` in integration tests*
+
+### Arguments
+
+- queryParams `GetHubItemsV2025R0QueryParams`
+  - Query parameters of getHubItemsV2025R0 method
+- headers `GetHubItemsV2025R0Headers`
+  - Headers of getHubItemsV2025R0 method
+
+
+### Returns
+
+This function returns a value of type `HubItemsV2025R0`.
+
+Retrieves the items associated with the specified Hub.
+
+
+## Manage hub items
+
+Adds and/or removes Hub items from a Hub.
+
+This operation is performed by calling function `createHubManageItemV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/post-hubs-id-manage-items/).
+
+*Currently we don't have an example for calling `createHubManageItemV2025R0` in integration tests*
+
+### Arguments
+
+- hubId `String`
+  - The unique identifier that represent a hub.  The ID for any hub can be determined by visiting this hub in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/hubs/123` the `hub_id` is `123`. Example: "12345"
+- requestBody `HubItemsManageRequestV2025R0`
+  - Request body of createHubManageItemV2025R0 method
+- headers `CreateHubManageItemV2025R0Headers`
+  - Headers of createHubManageItemV2025R0 method
+
+
+### Returns
+
+This function returns a value of type `HubItemsManageResponseV2025R0`.
+
+
+
+

docs/hubs.md

@@ -2,9 +2,12 @@
 
 
 - [List all hubs](#list-all-hubs)
+- [Create hub](#create-hub)
 - [List all hubs for requesting enterprise](#list-all-hubs-for-requesting-enterprise)
 - [Get hub information by ID](#get-hub-information-by-id)
+- [Update hub information by ID](#update-hub-information-by-id)
 - [Delete hub](#delete-hub)
+- [Copy hub](#copy-hub)
 
 ## List all hubs
 
@@ -35,6 +38,32 @@ This function returns a value of type `HubsV2025R0`.
 Returns all hubs for the given user or enterprise.
 
 
+## Create hub
+
+Creates a new Hub.
+
+This operation is performed by calling function `createHubV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/post-hubs/).
+
+*Currently we don't have an example for calling `createHubV2025R0` in integration tests*
+
+### Arguments
+
+- requestBody `HubCreateRequestV2025R0`
+  - Request body of createHubV2025R0 method
+- headers `CreateHubV2025R0Headers`
+  - Headers of createHubV2025R0 method
+
+
+### Returns
+
+This function returns a value of type `HubV2025R0`.
+
+Returns a new Hub object.
+
+
 ## List all hubs for requesting enterprise
 
 Retrieves all hubs for a given enterprise.
@@ -96,6 +125,34 @@ This function returns a value of type `HubV2025R0`.
 Returns a hub object.
 
 
+## Update hub information by ID
+
+Updates a Hub. Can be used to change title, description, or Hub settings.
+
+This operation is performed by calling function `updateHubByIdV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/put-hubs-id/).
+
+*Currently we don't have an example for calling `updateHubByIdV2025R0` in integration tests*
+
+### Arguments
+
+- hubId `String`
+  - The unique identifier that represent a hub.  The ID for any hub can be determined by visiting this hub in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/hubs/123` the `hub_id` is `123`. Example: "12345"
+- requestBody `HubUpdateRequestV2025R0`
+  - Request body of updateHubByIdV2025R0 method
+- headers `UpdateHubByIdV2025R0Headers`
+  - Headers of updateHubByIdV2025R0 method
+
+
+### Returns
+
+This function returns a value of type `HubV2025R0`.
+
+Returns a Hub object.
+
+
 ## Delete hub
 
 Deletes a single hub.
@@ -126,3 +183,33 @@ A blank response is returned if the hub was
 successfully deleted.
 
 
+## Copy hub
+
+Creates a copy of a Hub.
+
+The original Hub will not be modified.
+
+This operation is performed by calling function `createHubCopyV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/post-hubs-id-copy/).
+
+*Currently we don't have an example for calling `createHubCopyV2025R0` in integration tests*
+
+### Arguments
+
+- hubId `String`
+  - The unique identifier that represent a hub.  The ID for any hub can be determined by visiting this hub in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/hubs/123` the `hub_id` is `123`. Example: "12345"
+- requestBody `HubCopyRequestV2025R0`
+  - Request body of createHubCopyV2025R0 method
+- headers `CreateHubCopyV2025R0Headers`
+  - Headers of createHubCopyV2025R0 method
+
+
+### Returns
+
+This function returns a value of type `HubV2025R0`.
+
+Returns a new Hub object.
+
+

src/main/java/com/box/sdkgen/client/BoxClient.java

@@ -35,6 +35,7 @@
 import com.box.sdkgen.managers.folderwatermarks.FolderWatermarksManager;
 import com.box.sdkgen.managers.groups.GroupsManager;
 import com.box.sdkgen.managers.hubcollaborations.HubCollaborationsManager;
+import com.box.sdkgen.managers.hubitems.HubItemsManager;
 import com.box.sdkgen.managers.hubs.HubsManager;
 import com.box.sdkgen.managers.integrationmappings.IntegrationMappingsManager;
 import com.box.sdkgen.managers.invites.InvitesManager;
@@ -248,6 +249,8 @@ public class BoxClient {
 
   public final HubCollaborationsManager hubCollaborations;
 
+  public final HubItemsManager hubItems;
+
   public final ShieldListsManager shieldLists;
 
   public BoxClient(Authentication auth) {
@@ -569,6 +572,8 @@ public BoxClient(Authentication auth) {
             .auth(this.auth)
             .networkSession(this.networkSession)
             .build();
+    this.hubItems =
+        new HubItemsManager.Builder().auth(this.auth).networkSession(this.networkSession).build();
     this.shieldLists =
         new ShieldListsManager.Builder()
             .auth(this.auth)
@@ -895,6 +900,8 @@ protected BoxClient(Builder builder) {
             .auth(this.auth)
             .networkSession(this.networkSession)
             .build();
+    this.hubItems =
+        new HubItemsManager.Builder().auth(this.auth).networkSession(this.networkSession).build();
     this.shieldLists =
         new ShieldListsManager.Builder()
             .auth(this.auth)
@@ -1273,6 +1280,10 @@ public HubCollaborationsManager getHubCollaborations() {
     return hubCollaborations;
   }
 
+  public HubItemsManager getHubItems() {
+    return hubItems;
+  }
+
   public ShieldListsManager getShieldLists() {
     return shieldLists;
   }

src/main/java/com/box/sdkgen/managers/hubitems/CreateHubManageItemV2025R0Headers.java

@@ -0,0 +1,63 @@
+package com.box.sdkgen.managers.hubitems;
+
+import static com.box.sdkgen.internal.utils.UtilsManager.mapOf;
+
+import com.box.sdkgen.parameters.v2025r0.boxversionheaderv2025r0.BoxVersionHeaderV2025R0;
+import com.box.sdkgen.serialization.json.EnumWrapper;
+import java.util.Map;
+
+public class CreateHubManageItemV2025R0Headers {
+
+  public EnumWrapper<BoxVersionHeaderV2025R0> boxVersion;
+
+  public Map<String, String> extraHeaders;
+
+  public CreateHubManageItemV2025R0Headers() {
+    this.boxVersion = new EnumWrapper<BoxVersionHeaderV2025R0>(BoxVersionHeaderV2025R0._2025_0);
+    this.extraHeaders = mapOf();
+  }
+
+  protected CreateHubManageItemV2025R0Headers(Builder builder) {
+    this.boxVersion = builder.boxVersion;
+    this.extraHeaders = builder.extraHeaders;
+  }
+
+  public EnumWrapper<BoxVersionHeaderV2025R0> getBoxVersion() {
+    return boxVersion;
+  }
+
+  public Map<String, String> getExtraHeaders() {
+    return extraHeaders;
+  }
+
+  public static class Builder {
+
+    protected EnumWrapper<BoxVersionHeaderV2025R0> boxVersion;
+
+    protected Map<String, String> extraHeaders;
+
+    public Builder() {
+      this.boxVersion = new EnumWrapper<BoxVersionHeaderV2025R0>(BoxVersionHeaderV2025R0._2025_0);
+      this.extraHeaders = mapOf();
+    }
+
+    public Builder boxVersion(BoxVersionHeaderV2025R0 boxVersion) {
+      this.boxVersion = new EnumWrapper<BoxVersionHeaderV2025R0>(boxVersion);
+      return this;
+    }
+
+    public Builder boxVersion(EnumWrapper<BoxVersionHeaderV2025R0> boxVersion) {
+      this.boxVersion = boxVersion;
+      return this;
+    }
+
+    public Builder extraHeaders(Map<String, String> extraHeaders) {
+      this.extraHeaders = extraHeaders;
+      return this;
+    }
+
+    public CreateHubManageItemV2025R0Headers build() {
+      return new CreateHubManageItemV2025R0Headers(this);
+    }
+  }
+}

src/main/java/com/box/sdkgen/managers/hubitems/GetHubItemsV2025R0Headers.java

@@ -0,0 +1,63 @@
+package com.box.sdkgen.managers.hubitems;
+
+import static com.box.sdkgen.internal.utils.UtilsManager.mapOf;
+
+import com.box.sdkgen.parameters.v2025r0.boxversionheaderv2025r0.BoxVersionHeaderV2025R0;
+import com.box.sdkgen.serialization.json.EnumWrapper;
+import java.util.Map;
+
+public class GetHubItemsV2025R0Headers {
+
+  public EnumWrapper<BoxVersionHeaderV2025R0> boxVersion;
+
+  public Map<String, String> extraHeaders;
+
+  public GetHubItemsV2025R0Headers() {
+    this.boxVersion = new EnumWrapper<BoxVersionHeaderV2025R0>(BoxVersionHeaderV2025R0._2025_0);
+    this.extraHeaders = mapOf();
+  }
+
+  protected GetHubItemsV2025R0Headers(Builder builder) {
+    this.boxVersion = builder.boxVersion;
+    this.extraHeaders = builder.extraHeaders;
+  }
+
+  public EnumWrapper<BoxVersionHeaderV2025R0> getBoxVersion() {
+    return boxVersion;
+  }
+
+  public Map<String, String> getExtraHeaders() {
+    return extraHeaders;
+  }
+
+  public static class Builder {
+
+    protected EnumWrapper<BoxVersionHeaderV2025R0> boxVersion;
+
+    protected Map<String, String> extraHeaders;
+
+    public Builder() {
+      this.boxVersion = new EnumWrapper<BoxVersionHeaderV2025R0>(BoxVersionHeaderV2025R0._2025_0);
+      this.extraHeaders = mapOf();
+    }
+
+    public Builder boxVersion(BoxVersionHeaderV2025R0 boxVersion) {
+      this.boxVersion = new EnumWrapper<BoxVersionHeaderV2025R0>(boxVersion);
+      return this;
+    }
+
+    public Builder boxVersion(EnumWrapper<BoxVersionHeaderV2025R0> boxVersion) {
+      this.boxVersion = boxVersion;
+      return this;
+    }
+
+    public Builder extraHeaders(Map<String, String> extraHeaders) {
+      this.extraHeaders = extraHeaders;
+      return this;
+    }
+
+    public GetHubItemsV2025R0Headers build() {
+      return new GetHubItemsV2025R0Headers(this);
+    }
+  }
+}