feat: add GET enterprise configuration endpoint (box/box-openapi#559)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "192deac", "specHash": "fa34496", "version": "10.1.0" }
+{ "engineHash": "192deac", "specHash": "cf21406", "version": "10.1.0" }

Box.Sdk.Gen.Net/Client/BoxClient.cs

@@ -157,6 +157,8 @@ public class BoxClient : IBoxClient {
 
         public IDocgenManager Docgen { get; }
 
+        public IEnterpriseConfigurationsManager EnterpriseConfigurations { get; }
+
         public IHubsManager Hubs { get; }
 
         public IHubCollaborationsManager HubCollaborations { get; }
@@ -246,6 +248,7 @@ 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 };
+            EnterpriseConfigurations = new EnterpriseConfigurationsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             Hubs = new HubsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             HubCollaborations = new HubCollaborationsManager(networkSession: this.NetworkSession) { Auth = this.Auth };
             HubItems = new HubItemsManager(networkSession: this.NetworkSession) { Auth = this.Auth };

Box.Sdk.Gen.Net/Client/IBoxClient.cs

@@ -155,6 +155,8 @@ 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 IEnterpriseConfigurationsManager EnterpriseConfigurations { 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."); }

Box.Sdk.Gen.Net/Managers/EnterpriseConfigurations/EnterpriseConfigurationsManager.cs

@@ -0,0 +1,42 @@
+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 EnterpriseConfigurationsManager : IEnterpriseConfigurationsManager {
+        public IAuthentication? Auth { get; init; }
+
+        public NetworkSession NetworkSession { get; }
+
+        public EnterpriseConfigurationsManager(NetworkSession? networkSession = default) {
+            NetworkSession = networkSession ?? new NetworkSession();
+        }
+        /// <summary>
+        /// Retrieves the configuration for an enterprise.
+        /// </summary>
+        /// <param name="enterpriseId">
+        /// The ID of the enterprise.
+        /// Example: "3442311"
+        /// </param>
+        /// <param name="queryParams">
+        /// Query parameters of getEnterpriseConfigurationByIdV2025R0 method
+        /// </param>
+        /// <param name="headers">
+        /// Headers of getEnterpriseConfigurationByIdV2025R0 method
+        /// </param>
+        /// <param name="cancellationToken">
+        /// Token used for request cancellation.
+        /// </param>
+        public async System.Threading.Tasks.Task<EnterpriseConfigurationV2025R0> GetEnterpriseConfigurationByIdV2025R0Async(string enterpriseId, GetEnterpriseConfigurationByIdV2025R0QueryParams queryParams, GetEnterpriseConfigurationByIdV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) {
+            headers = headers ?? new GetEnterpriseConfigurationByIdV2025R0Headers();
+            Dictionary<string, string> queryParamsMap = Utils.PrepareParams(map: new Dictionary<string, string?>() { { "categories", StringUtils.ToStringRepresentation(queryParams.Categories) } });
+            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/enterprise_configurations/", StringUtils.ToStringRepresentation(enterpriseId)), 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<EnterpriseConfigurationV2025R0>(NullableUtils.Unwrap(response.Data));
+        }
+
+    }
+}

Box.Sdk.Gen.Net/Managers/EnterpriseConfigurations/GetEnterpriseConfigurationByIdV2025R0Headers.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 GetEnterpriseConfigurationByIdV2025R0Headers {
+        /// <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 GetEnterpriseConfigurationByIdV2025R0Headers(BoxVersionHeaderV2025R0 boxVersion = BoxVersionHeaderV2025R0._20250, Dictionary<string, string?>? extraHeaders = default) {
+            BoxVersion = boxVersion;
+            ExtraHeaders = extraHeaders ?? new Dictionary<string, string?>() {  };
+        }
+    }
+}

Box.Sdk.Gen.Net/Managers/EnterpriseConfigurations/GetEnterpriseConfigurationByIdV2025R0QueryParams.cs

@@ -0,0 +1,20 @@
+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 GetEnterpriseConfigurationByIdV2025R0QueryParams {
+        /// <summary>
+        /// The comma-delimited list of the enterprise configuration categories. 
+        /// Allowed values: `security`, `content_and_sharing`, `user_settings`, `shield`.
+        /// </summary>
+        public string Categories { get; }
+
+        public GetEnterpriseConfigurationByIdV2025R0QueryParams(string categories) {
+            Categories = categories;
+        }
+    }
+}

Box.Sdk.Gen.Net/Managers/EnterpriseConfigurations/IEnterpriseConfigurationsManager.cs

@@ -0,0 +1,29 @@
+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 interface IEnterpriseConfigurationsManager {
+        /// <summary>
+    /// Retrieves the configuration for an enterprise.
+    /// </summary>
+    /// <param name="enterpriseId">
+    /// The ID of the enterprise.
+    /// Example: "3442311"
+    /// </param>
+    /// <param name="queryParams">
+    /// Query parameters of getEnterpriseConfigurationByIdV2025R0 method
+    /// </param>
+    /// <param name="headers">
+    /// Headers of getEnterpriseConfigurationByIdV2025R0 method
+    /// </param>
+    /// <param name="cancellationToken">
+    /// Token used for request cancellation.
+    /// </param>
+    public System.Threading.Tasks.Task<EnterpriseConfigurationV2025R0> GetEnterpriseConfigurationByIdV2025R0Async(string enterpriseId, GetEnterpriseConfigurationByIdV2025R0QueryParams queryParams, GetEnterpriseConfigurationByIdV2025R0Headers? headers = default, System.Threading.CancellationToken? cancellationToken = null) => throw new System.NotImplementedException("This method needs to be implemented by the derived class before calling it.");
+
+    }
+}

Box.Sdk.Gen.Net/Schemas/V2025R0/CollaborationPermissionsV2025R0/CollaborationPermissionsV2025R0.cs

@@ -0,0 +1,71 @@
+using Box.Sdk.Gen;
+using System.Text.Json.Serialization;
+using System.Collections.Generic;
+using Box.Sdk.Gen.Internal;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class CollaborationPermissionsV2025R0 : ISerializable {
+        /// <summary>
+        /// The co-owner role is enabled for collaboration.
+        /// </summary>
+        [JsonPropertyName("is_co_owner_role_enabled")]
+        public bool? IsCoOwnerRoleEnabled { get; init; }
+
+        /// <summary>
+        /// The editor role is enabled for collaboration.
+        /// </summary>
+        [JsonPropertyName("is_editor_role_enabled")]
+        public bool? IsEditorRoleEnabled { get; init; }
+
+        /// <summary>
+        /// The previewer role is enabled for collaboration.
+        /// </summary>
+        [JsonPropertyName("is_previewer_role_enabled")]
+        public bool? IsPreviewerRoleEnabled { get; init; }
+
+        /// <summary>
+        /// The previewer uploader role is enabled for collaboration.
+        /// </summary>
+        [JsonPropertyName("is_previewer_uploader_role_enabled")]
+        public bool? IsPreviewerUploaderRoleEnabled { get; init; }
+
+        /// <summary>
+        /// The uploader role is enabled for collaboration.
+        /// </summary>
+        [JsonPropertyName("is_uploader_role_enabled")]
+        public bool? IsUploaderRoleEnabled { get; init; }
+
+        /// <summary>
+        /// The viewer role is enabled for collaboration.
+        /// </summary>
+        [JsonPropertyName("is_viewer_role_enabled")]
+        public bool? IsViewerRoleEnabled { get; init; }
+
+        /// <summary>
+        /// The viewer uploader role is enabled for collaboration.
+        /// </summary>
+        [JsonPropertyName("is_viewer_uploader_role_enabled")]
+        public bool? IsViewerUploaderRoleEnabled { get; init; }
+
+        public CollaborationPermissionsV2025R0() {
+            
+        }
+        internal string? RawJson { get; set; } = default;
+
+        void ISerializable.SetJson(string json) {
+            RawJson = json;
+        }
+
+        string? ISerializable.GetJson() {
+            return RawJson;
+        }
+
+        /// <summary>
+        /// Returns raw json response returned from the API.
+        /// </summary>
+        public Dictionary<string, object?>? GetRawData() {
+            return SimpleJsonSerializer.GetAllFields(this);
+        }
+
+    }
+}

Box.Sdk.Gen.Net/Schemas/V2025R0/CollaborationRestrictionV2025R0/CollaborationRestrictionV2025R0.cs

@@ -0,0 +1,11 @@
+using System.ComponentModel;
+using Box.Sdk.Gen.Internal;
+
+namespace Box.Sdk.Gen.Schemas {
+    public enum CollaborationRestrictionV2025R0 {
+        [Description("internal")]
+        Internal,
+        [Description("external")]
+        External
+    }
+}

Box.Sdk.Gen.Net/Schemas/V2025R0/CustomSessionDurationGroupItemV2025R0/CustomSessionDurationGroupItemV2025R0.cs

@@ -0,0 +1,41 @@
+using Box.Sdk.Gen;
+using System.Text.Json.Serialization;
+using System.Collections.Generic;
+using Box.Sdk.Gen.Internal;
+
+namespace Box.Sdk.Gen.Schemas {
+    public class CustomSessionDurationGroupItemV2025R0 : ISerializable {
+        /// <summary>
+        /// Group ID (numerical).
+        /// </summary>
+        [JsonPropertyName("id")]
+        public string? Id { get; init; }
+
+        /// <summary>
+        /// Group Name.
+        /// </summary>
+        [JsonPropertyName("name")]
+        public string? Name { get; init; }
+
+        public CustomSessionDurationGroupItemV2025R0() {
+            
+        }
+        internal string? RawJson { get; set; } = default;
+
+        void ISerializable.SetJson(string json) {
+            RawJson = json;
+        }
+
+        string? ISerializable.GetJson() {
+            return RawJson;
+        }
+
+        /// <summary>
+        /// Returns raw json response returned from the API.
+        /// </summary>
+        public Dictionary<string, object?>? GetRawData() {
+            return SimpleJsonSerializer.GetAllFields(this);
+        }
+
+    }
+}