feat: add hubs API beta endpoints (box/box-openapi#531)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "8a2df34", "specHash": "4beed7d", "version": "1.10.0" }
+{ "engineHash": "8a2df34", "specHash": "bf48b24", "version": "1.10.0" }

Box.Sdk.Gen/Client/BoxClient.cs

@@ -157,6 +157,10 @@ public class BoxClient : IBoxClient {
 
         public IDocgenManager Docgen { get; }
 
+        public IHubsManager Hubs { get; }
+
+        public IHubCollaborationsManager HubCollaborations { get; }
+
         public IShieldListsManager ShieldLists { get; }
 
         public BoxClient(IAuthentication auth, NetworkSession? networkSession = default) {
@@ -236,6 +240,8 @@ public BoxClient(IAuthentication auth, NetworkSession? networkSession = default)
             AiStudio = new AiStudioManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             DocgenTemplate = new DocgenTemplateManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             Docgen = new DocgenManager(networkSession: this.NetworkSession) { Auth = this.Auth };
+            Hubs = new HubsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
+            HubCollaborations = new HubCollaborationsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             ShieldLists = new ShieldListsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
         }
         /// <summary>

Box.Sdk.Gen/Client/IBoxClient.cs

@@ -155,6 +155,10 @@ public interface IBoxClient {
 
         public IDocgenManager Docgen { get => throw new System.NotImplementedException("This method needs to be implemented by the derived class before calling it."); }
 
+        public IHubsManager Hubs { get => throw new System.NotImplementedException("This method needs to be implemented by the derived class before calling it."); }
+
+        public IHubCollaborationsManager HubCollaborations { get => throw new System.NotImplementedException("This method needs to be implemented by the derived class before calling it."); }
+
         public IShieldListsManager ShieldLists { get => throw new System.NotImplementedException("This method needs to be implemented by the derived class before calling it."); }
 
     }

Box.Sdk.Gen/Managers/HubCollaborations/CreateHubCollaborationV2025R0Headers.cs

@@ -0,0 +1,25 @@
+using Box.Sdk.Gen;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Internal;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen.Parameters;
+
+namespace Box.Sdk.Gen.Managers {
+    public class CreateHubCollaborationV2025R0Headers {
+        /// <summary>
+        /// Version header.
+        /// </summary>
+        public StringEnum<BoxVersionHeaderV2025R0> BoxVersion { get; }
+
+        /// <summary>
+        /// Extra headers that will be included in the HTTP request.
+        /// </summary>
+        public Dictionary<string, string?> ExtraHeaders { get; }
+
+        public CreateHubCollaborationV2025R0Headers(BoxVersionHeaderV2025R0 boxVersion = BoxVersionHeaderV2025R0._20250, Dictionary<string, string?>? extraHeaders = default) {
+            BoxVersion = boxVersion;
+            ExtraHeaders = extraHeaders ?? new Dictionary<string, string?>() {  };
+        }
+    }
+}

Box.Sdk.Gen/Managers/HubCollaborations/DeleteHubCollaborationByIdV2025R0Headers.cs

@@ -0,0 +1,25 @@
+using Box.Sdk.Gen;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Internal;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen.Parameters;
+
+namespace Box.Sdk.Gen.Managers {
+    public class DeleteHubCollaborationByIdV2025R0Headers {
+        /// <summary>
+        /// Version header.
+        /// </summary>
+        public StringEnum<BoxVersionHeaderV2025R0> BoxVersion { get; }
+
+        /// <summary>
+        /// Extra headers that will be included in the HTTP request.
+        /// </summary>
+        public Dictionary<string, string?> ExtraHeaders { get; }
+
+        public DeleteHubCollaborationByIdV2025R0Headers(BoxVersionHeaderV2025R0 boxVersion = BoxVersionHeaderV2025R0._20250, Dictionary<string, string?>? extraHeaders = default) {
+            BoxVersion = boxVersion;
+            ExtraHeaders = extraHeaders ?? new Dictionary<string, string?>() {  };
+        }
+    }
+}

Box.Sdk.Gen/Managers/HubCollaborations/GetHubCollaborationByIdV2025R0Headers.cs

@@ -0,0 +1,25 @@
+using Box.Sdk.Gen;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Internal;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen.Parameters;
+
+namespace Box.Sdk.Gen.Managers {
+    public class GetHubCollaborationByIdV2025R0Headers {
+        /// <summary>
+        /// Version header.
+        /// </summary>
+        public StringEnum<BoxVersionHeaderV2025R0> BoxVersion { get; }
+
+        /// <summary>
+        /// Extra headers that will be included in the HTTP request.
+        /// </summary>
+        public Dictionary<string, string?> ExtraHeaders { get; }
+
+        public GetHubCollaborationByIdV2025R0Headers(BoxVersionHeaderV2025R0 boxVersion = BoxVersionHeaderV2025R0._20250, Dictionary<string, string?>? extraHeaders = default) {
+            BoxVersion = boxVersion;
+            ExtraHeaders = extraHeaders ?? new Dictionary<string, string?>() {  };
+        }
+    }
+}

Box.Sdk.Gen/Managers/HubCollaborations/GetHubCollaborationsV2025R0Headers.cs

@@ -0,0 +1,25 @@
+using Box.Sdk.Gen;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Internal;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen.Parameters;
+
+namespace Box.Sdk.Gen.Managers {
+    public class GetHubCollaborationsV2025R0Headers {
+        /// <summary>
+        /// Version header.
+        /// </summary>
+        public StringEnum<BoxVersionHeaderV2025R0> BoxVersion { get; }
+
+        /// <summary>
+        /// Extra headers that will be included in the HTTP request.
+        /// </summary>
+        public Dictionary<string, string?> ExtraHeaders { get; }
+
+        public GetHubCollaborationsV2025R0Headers(BoxVersionHeaderV2025R0 boxVersion = BoxVersionHeaderV2025R0._20250, Dictionary<string, string?>? extraHeaders = default) {
+            BoxVersion = boxVersion;
+            ExtraHeaders = extraHeaders ?? new Dictionary<string, string?>() {  };
+        }
+    }
+}

Box.Sdk.Gen/Managers/HubCollaborations/GetHubCollaborationsV2025R0QueryParams.cs

@@ -0,0 +1,38 @@
+using Box.Sdk.Gen;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Internal;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen.Parameters;
+
+namespace Box.Sdk.Gen.Managers {
+    public class GetHubCollaborationsV2025R0QueryParams {
+        /// <summary>
+        /// 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`.
+        /// </summary>
+        public string HubId { get; }
+
+        /// <summary>
+        /// Defines the position marker at which to begin returning results. This is
+        /// used when paginating using marker-based pagination.
+        /// 
+        /// This requires `usemarker` to be set to `true`.
+        /// </summary>
+        public string? Marker { get; init; }
+
+        /// <summary>
+        /// The maximum number of items to return per page.
+        /// </summary>
+        public long? Limit { get; init; }
+
+        public GetHubCollaborationsV2025R0QueryParams(string hubId) {
+            HubId = hubId;
+        }
+    }
+}

Box.Sdk.Gen/Managers/HubCollaborations/HubCollaborationsManager.cs

@@ -0,0 +1,122 @@
+using Box.Sdk.Gen;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using Box.Sdk.Gen.Internal;
+using Box.Sdk.Gen.Schemas;
+using Box.Sdk.Gen.Parameters;
+
+namespace Box.Sdk.Gen.Managers {
+    public class HubCollaborationsManager : IHubCollaborationsManager {
+        public IAuthentication? Auth { get; init; }
+
+        public NetworkSession NetworkSession { get; }
+
+        public HubCollaborationsManager(NetworkSession? networkSession = default) {
+            NetworkSession = networkSession ?? new NetworkSession();
+        }
+        /// <summary>
+        /// Retrieves all collaborations for a hub.
+        /// </summary>
+        /// <param name="queryParams">
+        /// Query parameters of getHubCollaborationsV2025R0 method
+        /// </param>
+        /// <param name="headers">
+        /// Headers of getHubCollaborationsV2025R0 method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task<HubCollaborationsV2025R0> GetHubCollaborationsV2025R0Async(GetHubCollaborationsV2025R0QueryParams queryParams, GetHubCollaborationsV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new GetHubCollaborationsV2025R0Headers();
+            Dictionary<string, string> queryParamsMap = Utils.PrepareParams(map: new Dictionary<string, string?>() { { "hub_id", StringUtils.ToStringRepresentation(queryParams.HubId) }, { "marker", StringUtils.ToStringRepresentation(queryParams.Marker) }, { "limit", StringUtils.ToStringRepresentation(queryParams.Limit) } });
+            Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() { { "box-version", StringUtils.ToStringRepresentation(headers.BoxVersion) } }, headers.ExtraHeaders));
+            FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/hub_collaborations"), method: "GET", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Parameters = queryParamsMap, Headers = headersMap, Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
+            return SimpleJsonSerializer.Deserialize<HubCollaborationsV2025R0>(NullableUtils.Unwrap(response.Data));
+        }
+
+        /// <summary>
+        /// Adds a collaboration for a single user or a single group to a hub.
+        /// 
+        /// Collaborations can be created using email address, user IDs, or group IDs.
+        /// </summary>
+        /// <param name="requestBody">
+        /// Request body of createHubCollaborationV2025R0 method
+        /// </param>
+        /// <param name="headers">
+        /// Headers of createHubCollaborationV2025R0 method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task<HubCollaborationV2025R0> CreateHubCollaborationV2025R0Async(HubCollaborationCreateRequestV2025R0 requestBody, CreateHubCollaborationV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new CreateHubCollaborationV2025R0Headers();
+            Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() { { "box-version", StringUtils.ToStringRepresentation(headers.BoxVersion) } }, headers.ExtraHeaders));
+            FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/hub_collaborations"), method: "POST", contentType: "application/json", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Headers = headersMap, Data = SimpleJsonSerializer.Serialize(requestBody), Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
+            return SimpleJsonSerializer.Deserialize<HubCollaborationV2025R0>(NullableUtils.Unwrap(response.Data));
+        }
+
+        /// <summary>
+        /// Retrieves details for a hub collaboration by collaboration ID.
+        /// </summary>
+        /// <param name="hubCollaborationId">
+        /// The ID of the hub collaboration.
+        /// Example: "1234"
+        /// </param>
+        /// <param name="headers">
+        /// Headers of getHubCollaborationByIdV2025R0 method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task<HubCollaborationV2025R0> GetHubCollaborationByIdV2025R0Async(string hubCollaborationId, GetHubCollaborationByIdV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new GetHubCollaborationByIdV2025R0Headers();
+            Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() { { "box-version", StringUtils.ToStringRepresentation(headers.BoxVersion) } }, headers.ExtraHeaders));
+            FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/hub_collaborations/", StringUtils.ToStringRepresentation(hubCollaborationId)), method: "GET", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Headers = headersMap, Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
+            return SimpleJsonSerializer.Deserialize<HubCollaborationV2025R0>(NullableUtils.Unwrap(response.Data));
+        }
+
+        /// <summary>
+        /// Updates a hub collaboration.
+        /// Can be used to change the hub role.
+        /// </summary>
+        /// <param name="hubCollaborationId">
+        /// The ID of the hub collaboration.
+        /// Example: "1234"
+        /// </param>
+        /// <param name="requestBody">
+        /// Request body of updateHubCollaborationByIdV2025R0 method
+        /// </param>
+        /// <param name="headers">
+        /// Headers of updateHubCollaborationByIdV2025R0 method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task<HubCollaborationV2025R0> UpdateHubCollaborationByIdV2025R0Async(string hubCollaborationId, HubCollaborationUpdateRequestV2025R0 requestBody, UpdateHubCollaborationByIdV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new UpdateHubCollaborationByIdV2025R0Headers();
+            Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() { { "box-version", StringUtils.ToStringRepresentation(headers.BoxVersion) } }, headers.ExtraHeaders));
+            FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/hub_collaborations/", StringUtils.ToStringRepresentation(hubCollaborationId)), method: "PUT", contentType: "application/json", responseFormat: Box.Sdk.Gen.ResponseFormat.Json) { Headers = headersMap, Data = SimpleJsonSerializer.Serialize(requestBody), Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
+            return SimpleJsonSerializer.Deserialize<HubCollaborationV2025R0>(NullableUtils.Unwrap(response.Data));
+        }
+
+        /// <summary>
+        /// Deletes a single hub collaboration.
+        /// </summary>
+        /// <param name="hubCollaborationId">
+        /// The ID of the hub collaboration.
+        /// Example: "1234"
+        /// </param>
+        /// <param name="headers">
+        /// Headers of deleteHubCollaborationByIdV2025R0 method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task DeleteHubCollaborationByIdV2025R0Async(string hubCollaborationId, DeleteHubCollaborationByIdV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new DeleteHubCollaborationByIdV2025R0Headers();
+            Dictionary<string, string> headersMap = Utils.PrepareParams(map: DictionaryUtils.MergeDictionaries(new Dictionary<string, string?>() { { "box-version", StringUtils.ToStringRepresentation(headers.BoxVersion) } }, headers.ExtraHeaders));
+            FetchResponse response = await this.NetworkSession.NetworkClient.FetchAsync(options: new FetchOptions(url: string.Concat(this.NetworkSession.BaseUrls.BaseUrl, "/2.0/hub_collaborations/", StringUtils.ToStringRepresentation(hubCollaborationId)), method: "DELETE", responseFormat: Box.Sdk.Gen.ResponseFormat.NoContent) { Headers = headersMap, Auth = this.Auth, NetworkSession = this.NetworkSession, CancellationToken = cancellationToken }).ConfigureAwait(false);
+        }
+
+    }
+}