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

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "b98d1dc", "specHash": "fa34496", "version": "4.0.0" }
+{ "engineHash": "b98d1dc", "specHash": "cf21406", "version": "4.0.0" }

box_sdk_gen/client.py

@@ -172,6 +172,10 @@
 
 from box_sdk_gen.managers.docgen import DocgenManager
 
+from box_sdk_gen.managers.enterprise_configurations import (
+    EnterpriseConfigurationsManager,
+)
+
 from box_sdk_gen.managers.hubs import HubsManager
 
 from box_sdk_gen.managers.hub_collaborations import HubCollaborationsManager
@@ -429,6 +433,9 @@ def __init__(self, auth: Authentication, *, network_session: NetworkSession = No
         self.docgen = DocgenManager(
             auth=self.auth, network_session=self.network_session
         )
+        self.enterprise_configurations = EnterpriseConfigurationsManager(
+            auth=self.auth, network_session=self.network_session
+        )
         self.hubs = HubsManager(auth=self.auth, network_session=self.network_session)
         self.hub_collaborations = HubCollaborationsManager(
             auth=self.auth, network_session=self.network_session

box_sdk_gen/managers/__init__.py

@@ -146,6 +146,8 @@
 
 from box_sdk_gen.managers.docgen import *
 
+from box_sdk_gen.managers.enterprise_configurations import *
+
 from box_sdk_gen.managers.hubs import *
 
 from box_sdk_gen.managers.hub_collaborations import *

box_sdk_gen/managers/enterprise_configurations.py

@@ -0,0 +1,100 @@
+from typing import Optional
+
+from typing import Dict
+
+from box_sdk_gen.internal.utils import to_string
+
+from box_sdk_gen.serialization.json import deserialize
+
+from box_sdk_gen.networking.fetch_options import ResponseFormat
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_v2025_r0 import (
+    EnterpriseConfigurationV2025R0,
+)
+
+from box_sdk_gen.schemas.v2025_r0.client_error_v2025_r0 import ClientErrorV2025R0
+
+from box_sdk_gen.parameters.v2025_r0.box_version_header_v2025_r0 import (
+    BoxVersionHeaderV2025R0,
+)
+
+from box_sdk_gen.box.errors import BoxSDKError
+
+from box_sdk_gen.networking.auth import Authentication
+
+from box_sdk_gen.networking.network import NetworkSession
+
+from box_sdk_gen.networking.fetch_options import FetchOptions
+
+from box_sdk_gen.networking.fetch_response import FetchResponse
+
+from box_sdk_gen.internal.utils import prepare_params
+
+from box_sdk_gen.internal.utils import to_string
+
+from box_sdk_gen.internal.utils import ByteStream
+
+from box_sdk_gen.serialization.json import sd_to_json
+
+from box_sdk_gen.serialization.json import SerializedData
+
+
+class EnterpriseConfigurationsManager:
+    def __init__(
+        self,
+        *,
+        auth: Optional[Authentication] = None,
+        network_session: NetworkSession = None
+    ):
+        if network_session is None:
+            network_session = NetworkSession()
+        self.auth = auth
+        self.network_session = network_session
+
+    def get_enterprise_configuration_by_id_v2025_r0(
+        self,
+        enterprise_id: str,
+        categories: str,
+        *,
+        box_version: BoxVersionHeaderV2025R0 = BoxVersionHeaderV2025R0._2025_0,
+        extra_headers: Optional[Dict[str, Optional[str]]] = None
+    ) -> EnterpriseConfigurationV2025R0:
+        """
+                Retrieves the configuration for an enterprise.
+                :param enterprise_id: The ID of the enterprise.
+        Example: "3442311"
+                :type enterprise_id: str
+                :param categories: The comma-delimited list of the enterprise configuration categories.
+        Allowed values: `security`, `content_and_sharing`, `user_settings`, `shield`.
+                :type categories: str
+                :param box_version: Version header., defaults to BoxVersionHeaderV2025R0._2025_0
+                :type box_version: BoxVersionHeaderV2025R0, optional
+                :param extra_headers: Extra headers that will be included in the HTTP request., defaults to None
+                :type extra_headers: Optional[Dict[str, Optional[str]]], optional
+        """
+        if extra_headers is None:
+            extra_headers = {}
+        query_params_map: Dict[str, str] = prepare_params(
+            {'categories': to_string(categories)}
+        )
+        headers_map: Dict[str, str] = prepare_params(
+            {'box-version': to_string(box_version), **extra_headers}
+        )
+        response: FetchResponse = self.network_session.network_client.fetch(
+            FetchOptions(
+                url=''.join(
+                    [
+                        self.network_session.base_urls.base_url,
+                        '/2.0/enterprise_configurations/',
+                        to_string(enterprise_id),
+                    ]
+                ),
+                method='GET',
+                params=query_params_map,
+                headers=headers_map,
+                response_format=ResponseFormat.JSON,
+                auth=self.auth,
+                network_session=self.network_session,
+            )
+        )
+        return deserialize(response.data, EnterpriseConfigurationV2025R0)

box_sdk_gen/schemas/v2025_r0/__init__.py

@@ -4,6 +4,12 @@
 
 from box_sdk_gen.schemas.v2025_r0.client_error_v2025_r0 import *
 
+from box_sdk_gen.schemas.v2025_r0.collaboration_permissions_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.collaboration_restriction_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.custom_session_duration_group_item_v2025_r0 import *
+
 from box_sdk_gen.schemas.v2025_r0.doc_gen_batch_base_v2025_r0 import *
 
 from box_sdk_gen.schemas.v2025_r0.doc_gen_document_generation_data_v2025_r0 import *
@@ -16,8 +22,18 @@
 
 from box_sdk_gen.schemas.v2025_r0.doc_gen_tags_processing_message_v2025_r0 import *
 
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_item_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_item_string_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_item_integer_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_item_boolean_v2025_r0 import *
+
 from box_sdk_gen.schemas.v2025_r0.enterprise_reference_v2025_r0 import *
 
+from box_sdk_gen.schemas.v2025_r0.external_collab_security_settings_v2025_r0 import *
+
 from box_sdk_gen.schemas.v2025_r0.external_user_deletion_result_v2025_r0 import *
 
 from box_sdk_gen.schemas.v2025_r0.external_users_submit_delete_job_response_v2025_r0 import *
@@ -62,6 +78,14 @@
 
 from box_sdk_gen.schemas.v2025_r0.hub_update_request_v2025_r0 import *
 
+from box_sdk_gen.schemas.v2025_r0.keysafe_settings_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_security_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.list_user_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.shared_link_permissions_v2025_r0 import *
+
 from box_sdk_gen.schemas.v2025_r0.shield_list_mini_v2025_r0 import *
 
 from box_sdk_gen.schemas.v2025_r0.shield_lists_v2025_r0 import *
@@ -86,6 +110,10 @@
 
 from box_sdk_gen.schemas.v2025_r0.shield_list_v2025_r0 import *
 
+from box_sdk_gen.schemas.v2025_r0.shield_rule_item_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_shield_v2025_r0 import *
+
 from box_sdk_gen.schemas.v2025_r0.terms_of_service_base_v2025_r0 import *
 
 from box_sdk_gen.schemas.v2025_r0.user_base_v2025_r0 import *
@@ -108,10 +136,24 @@
 
 from box_sdk_gen.schemas.v2025_r0.doc_gen_jobs_full_v2025_r0 import *
 
+from box_sdk_gen.schemas.v2025_r0.user_or_group_reference_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_feature_setting_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_feature_settings_item_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_content_and_sharing_v2025_r0 import *
+
 from box_sdk_gen.schemas.v2025_r0.user_reference_v2025_r0 import *
 
 from box_sdk_gen.schemas.v2025_r0.external_users_submit_delete_job_request_v2025_r0 import *
 
+from box_sdk_gen.schemas.v2025_r0.user_tracking_code_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_user_settings_v2025_r0 import *
+
+from box_sdk_gen.schemas.v2025_r0.enterprise_configuration_v2025_r0 import *
+
 from box_sdk_gen.schemas.v2025_r0.weblink_reference_v2025_r0 import *
 
 from box_sdk_gen.schemas.v2025_r0.hub_item_reference_v2025_r0 import *

box_sdk_gen/schemas/v2025_r0/collaboration_permissions_v2025_r0.py

@@ -0,0 +1,44 @@
+from typing import Optional
+
+from box_sdk_gen.internal.base_object import BaseObject
+
+from box_sdk_gen.box.errors import BoxSDKError
+
+
+class CollaborationPermissionsV2025R0(BaseObject):
+    def __init__(
+        self,
+        *,
+        is_co_owner_role_enabled: Optional[bool] = None,
+        is_editor_role_enabled: Optional[bool] = None,
+        is_previewer_role_enabled: Optional[bool] = None,
+        is_previewer_uploader_role_enabled: Optional[bool] = None,
+        is_uploader_role_enabled: Optional[bool] = None,
+        is_viewer_role_enabled: Optional[bool] = None,
+        is_viewer_uploader_role_enabled: Optional[bool] = None,
+        **kwargs
+    ):
+        """
+        :param is_co_owner_role_enabled: The co-owner role is enabled for collaboration., defaults to None
+        :type is_co_owner_role_enabled: Optional[bool], optional
+        :param is_editor_role_enabled: The editor role is enabled for collaboration., defaults to None
+        :type is_editor_role_enabled: Optional[bool], optional
+        :param is_previewer_role_enabled: The previewer role is enabled for collaboration., defaults to None
+        :type is_previewer_role_enabled: Optional[bool], optional
+        :param is_previewer_uploader_role_enabled: The previewer uploader role is enabled for collaboration., defaults to None
+        :type is_previewer_uploader_role_enabled: Optional[bool], optional
+        :param is_uploader_role_enabled: The uploader role is enabled for collaboration., defaults to None
+        :type is_uploader_role_enabled: Optional[bool], optional
+        :param is_viewer_role_enabled: The viewer role is enabled for collaboration., defaults to None
+        :type is_viewer_role_enabled: Optional[bool], optional
+        :param is_viewer_uploader_role_enabled: The viewer uploader role is enabled for collaboration., defaults to None
+        :type is_viewer_uploader_role_enabled: Optional[bool], optional
+        """
+        super().__init__(**kwargs)
+        self.is_co_owner_role_enabled = is_co_owner_role_enabled
+        self.is_editor_role_enabled = is_editor_role_enabled
+        self.is_previewer_role_enabled = is_previewer_role_enabled
+        self.is_previewer_uploader_role_enabled = is_previewer_uploader_role_enabled
+        self.is_uploader_role_enabled = is_uploader_role_enabled
+        self.is_viewer_role_enabled = is_viewer_role_enabled
+        self.is_viewer_uploader_role_enabled = is_viewer_uploader_role_enabled

box_sdk_gen/schemas/v2025_r0/collaboration_restriction_v2025_r0.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+from box_sdk_gen.box.errors import BoxSDKError
+
+
+class CollaborationRestrictionV2025R0(str, Enum):
+    INTERNAL = 'internal'
+    EXTERNAL = 'external'

box_sdk_gen/schemas/v2025_r0/custom_session_duration_group_item_v2025_r0.py

@@ -0,0 +1,20 @@
+from typing import Optional
+
+from box_sdk_gen.internal.base_object import BaseObject
+
+from box_sdk_gen.box.errors import BoxSDKError
+
+
+class CustomSessionDurationGroupItemV2025R0(BaseObject):
+    def __init__(
+        self, *, id: Optional[str] = None, name: Optional[str] = None, **kwargs
+    ):
+        """
+        :param id: Group ID (numerical)., defaults to None
+        :type id: Optional[str], optional
+        :param name: Group Name., defaults to None
+        :type name: Optional[str], optional
+        """
+        super().__init__(**kwargs)
+        self.id = id
+        self.name = name