> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Enterprise Configurations resources
Enterprise configurations which admins can interact with for a given enterprise.
## Enterprise configuration
The enterprise configuration for a given enterprise.
| Property | Type | Required | Description |
| --------------------- | --------------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `string` | No | The identifier of the enterprise configuration which is the ID of the enterprise. |
| `type` | `enum` | No | The value will always be `enterprise_configuration`. Available options: `enterprise_configuration`. |
| `security` | [Enterprise configuration security](#enterprise-configuration-security) | No | The enterprise configurations for the security category. Can be `null`. |
| `content_and_sharing` | [Enterprise configuration content and sharing](#enterprise-configuration-content-and-sharing) | No | The enterprise configurations for the content and sharing category. Can be `null`. |
| `user_settings` | [Enterprise configuration user settings](#enterprise-configuration-user-settings) | No | The enterprise configurations for the user settings category. Can be `null`. |
| `shield` | [Enterprise configuration shield](#enterprise-configuration-shield) | No | The enterprise configurations for the shield category. If shield is turned off for given enterprise, the response will be 404. Can be `null`. |
```json Example theme={null}
{
"id": "11446498",
"type": "enterprise_configuration",
"security": {
"is_managed_user_signup_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_signup_notification_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_signup_corporate_email_enabled": {
"is_used": true,
"value": true
},
"is_new_user_notification_daily_digest_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_email_change_disabled": {
"is_used": true,
"value": true
},
"is_multi_factor_auth_required": {
"is_used": true,
"value": true
},
"is_weak_password_prevention_enabled": {
"is_used": true,
"value": true
},
"is_password_leak_detection_enabled": {
"is_used": true,
"value": true
},
"last_password_reset_at": {
"is_used": true,
"value": "2012-12-12T10:53:43-08:00"
},
"is_password_request_notification_enabled": {
"is_used": true,
"value": true
},
"is_password_change_notification_enabled": {
"is_used": true,
"value": true
},
"is_strong_password_for_ext_collab_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_migration_disabled": {
"is_used": true,
"value": true
},
"join_link": {
"is_used": true,
"value": "value of configuration"
},
"join_url": {
"is_used": true,
"value": "value of configuration"
},
"failed_login_attempts_to_trigger_admin_notification": {
"is_used": true,
"value": 1234
},
"password_min_length": {
"is_used": true,
"value": 1234
},
"password_min_uppercase_characters": {
"is_used": true,
"value": 1234
},
"password_min_numeric_characters": {
"is_used": true,
"value": 1234
},
"password_min_special_characters": {
"is_used": true,
"value": 1234
},
"password_reset_frequency": {
"is_used": true,
"value": "value of configuration"
},
"previous_password_reuse_limit": {
"is_used": true,
"value": "value of configuration"
},
"session_duration": {
"is_used": true,
"value": "value of configuration"
},
"external_collab_multi_factor_auth_settings": {
"is_used": true,
"value": {
"denylist_domains": [
"example.com"
],
"denylist_emails": [
"spam@example.com"
],
"allowlist_domains": [
"example.com"
],
"allowlist_emails": [
"mail@example.com"
],
"state": "enabled",
"scheduled_status": "inprogress",
"scheduled_at": "2012-12-12T10:53:43-08:00",
"factor_type_settings": "totp"
}
},
"keysafe": {
"is_used": true,
"value": {
"keysafe_enabled": true,
"cloud_provider": "",
"key_id": "1234",
"account_id": "1234",
"location_id": "1234",
"project_id": "1234",
"keyring_id": "1234"
}
},
"is_custom_session_duration_enabled": {
"is_used": true,
"value": true
},
"custom_session_duration_value": {
"is_used": true,
"value": "value of configuration"
},
"custom_session_duration_groups": {
"is_used": true,
"value": [
{
"id": "1234",
"name": "Group Name"
}
]
},
"multi_factor_auth_type": {
"is_used": true,
"value": "value of configuration"
},
"enforced_mfa_frequency": {
"is_used": true,
"value": {
"days": 30,
"hours": 24
}
}
},
"content_and_sharing": {
"enterprise_feature_settings": [
{
"is_used": true,
"value": {
"id": "eyJlbnRlcnByaXNlSWQiOiIxMTExNDQyNzY3IiwiZmVhdHVyZUlkIjoiY2FudmFzIn0=",
"feature": {
"id": "canvas"
},
"state": "enabled",
"can_configure": true,
"is_configured": true,
"allowlist": [
{
"type": "user",
"id": "12345"
}
],
"denylist": [
{
"type": "user",
"id": "12345"
}
]
}
}
],
"sharing_item_type": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_company_definition": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_access": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_default_access": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_default_permissions_selected": {
"is_used": true,
"value": {
"shared_links_option": "settings_shared_link_preview",
"default_shared_link_type": "settings_default_shared_link_preview",
"notes_shared_link_option": "settings_notes_option_to_edit",
"default_notes_shared_link_type": "settings_default_notes_shared_link_to_edit"
}
},
"is_open_custom_urls_disabled": {
"is_used": true,
"value": true
},
"is_custom_domain_hidden_in_shared_link": {
"is_used": true,
"value": true
},
"collaboration_permissions": {
"is_used": true,
"value": {
"is_co_owner_role_enabled": true,
"is_editor_role_enabled": true,
"is_previewer_role_enabled": true,
"is_previewer_uploader_role_enabled": true,
"is_uploader_role_enabled": true,
"is_viewer_role_enabled": true,
"is_viewer_uploader_role_enabled": true
}
},
"default_collaboration_role": {
"is_used": true,
"value": "value of configuration"
},
"is_invite_privilege_restricted": {
"is_used": true,
"value": true
},
"collaboration_restrictions": {
"is_used": true,
"value": [
"internal"
]
},
"is_collaborator_invite_links_disabled": {
"is_used": true,
"value": true
},
"is_invite_group_collaborator_disabled": {
"is_used": true,
"value": true
},
"is_ownership_transfer_restricted": {
"is_used": true,
"value": true
},
"external_collaboration_status": {
"is_used": true,
"value": "enable_external_collaboration"
},
"external_collaboration_allowlist_users": {
"is_used": true,
"value": [
{
"id": 1234,
"name": "John Doe",
"email": "johndoe@box.com"
}
]
},
"is_watermarking_enterprise_feature_enabled": {
"is_used": true,
"value": true
},
"is_root_content_creation_restricted": {
"is_used": true,
"value": true
},
"is_tag_creation_restricted": {
"is_used": true,
"value": true
},
"tag_creation_restriction": {
"is_used": true,
"value": "value of configuration"
},
"is_email_uploads_enabled": {
"is_used": true,
"value": true
},
"is_custom_settings_enabled": {
"is_used": true,
"value": true
},
"is_forms_login_required": {
"is_used": true,
"value": true
},
"is_forms_branding_default_enabled": {
"is_used": true,
"value": true
},
"is_cc_free_trial_active": {
"is_used": true,
"value": true
},
"is_file_request_editors_allowed": {
"is_used": true,
"value": true
},
"is_file_request_branding_default_enabled": {
"is_used": true,
"value": true
},
"is_file_request_login_required": {
"is_used": true,
"value": true
},
"is_shared_links_expiration_enabled": {
"is_used": true,
"value": true
},
"shared_links_expiration_days": {
"is_used": true,
"value": 1234
},
"is_public_shared_links_expiration_enabled": {
"is_used": true,
"value": true
},
"public_shared_links_expiration_days": {
"is_used": true,
"value": 1234
},
"shared_expiration_target": {
"is_used": true,
"value": "value of configuration"
},
"is_shared_links_expiration_notification_enabled": {
"is_used": true,
"value": true
},
"shared_links_expiration_notification_days": {
"is_used": true,
"value": 1234
},
"is_shared_links_expiration_notification_prevented": {
"is_used": true,
"value": true
},
"is_auto_delete_enabled": {
"is_used": true,
"value": true
},
"auto_delete_days": {
"is_used": true,
"value": 1234
},
"is_auto_delete_expiration_modification_prevented": {
"is_used": true,
"value": true
},
"auto_delete_target": {
"is_used": true,
"value": "value of configuration"
},
"is_collaboration_expiration_enabled": {
"is_used": true,
"value": true
},
"collaboration_expiration_days": {
"is_used": true,
"value": 1234
},
"is_collaboration_expiration_modification_prevented": {
"is_used": true,
"value": true
},
"is_collaboration_expiration_notification_enabled": {
"is_used": true,
"value": true
},
"collaboration_expiration_target": {
"is_used": true,
"value": "value of configuration"
},
"trash_auto_clear_time": {
"is_used": true,
"value": 1234
},
"permanent_deletion_access": {
"is_used": true,
"value": "value of configuration"
},
"permanent_deletion_allowlist_users": {
"is_used": true,
"value": [
{
"id": 1234,
"name": "John Doe",
"email": "johndoe@box.com"
}
]
}
},
"user_settings": {
"enterprise_feature_settings": [
{
"is_used": true,
"value": {
"id": "eyJlbnRlcnByaXNlSWQiOiIxMTExNDQyNzY3IiwiZmVhdHVyZUlkIjoiY2FudmFzIn0=",
"feature": {
"id": "canvas"
},
"state": "enabled",
"can_configure": true,
"is_configured": true,
"allowlist": [
{
"type": "user",
"id": "12345"
}
],
"denylist": [
{
"type": "user",
"id": "12345"
}
]
}
}
],
"user_invites_expiration_time_frame": {
"is_used": true,
"value": "7 days"
},
"is_username_change_restricted": {
"is_used": true,
"value": true
},
"is_box_sync_restricted_for_new_users": {
"is_used": true,
"value": true
},
"is_view_all_users_enabled_for_new_users": {
"is_used": true,
"value": true
},
"is_device_limit_exemption_enabled_for_new_users": {
"is_used": true,
"value": true
},
"is_external_collaboration_restricted_for_new_users": {
"is_used": true,
"value": true
},
"is_unlimited_storage_enabled_for_new_users": {
"is_used": true,
"value": true
},
"new_user_default_storage_limit": {
"is_used": true,
"value": 1234
},
"new_user_default_timezone": {
"is_used": true,
"value": "GMT-05:00 America\\/Chicago CDT"
},
"new_user_default_language": {
"is_used": true,
"value": "English (US)"
},
"is_enterprise_sso_required": {
"is_used": true,
"value": true
},
"is_enterprise_sso_in_testing": {
"is_used": true,
"value": true
},
"is_sso_auto_add_groups_enabled": {
"is_used": true,
"value": true
},
"is_sso_auto_add_user_to_groups_enabled": {
"is_used": true,
"value": true
},
"is_sso_auto_remove_user_from_groups_enabled": {
"is_used": true,
"value": true
},
"user_tracking_codes": {
"is_used": true,
"value": [
{
"id": 1234,
"name": "Employee ID"
}
]
},
"number_of_user_tracking_codes_remaining": {
"is_used": true,
"value": 1234
},
"is_instant_login_restricted": {
"is_used": true,
"value": true
}
},
"shield": {
"shield_rules": [
{
"id": "1234567890",
"type": "shield_rule",
"rule_category": "Malicious Content",
"name": "Block malicious files",
"description": "Blocks files identified as malicious content",
"priority": "high",
"created_at": "2012-12-12T10:53:43-08:00",
"modified_at": "2012-12-12T10:53:43-08:00"
}
]
}
}
```
## Enterprise configuration content and sharing
The enterprise configuration for the content and sharing category.
| Property | Type | Required | Description |
| ---------------------------------------------------- | -------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `enterprise_feature_settings` | array of `Enterprise feature settings item` | No | |
| `sharing_item_type` | `Enterprise configuration item with string value` | No | The selected option for the type of items that sharing is enable for. |
| `shared_link_company_definition` | `Enterprise configuration item with string value` | No | The definition of the company for shared links (such as `enterprise_id`, `users_with_email_domain`). |
| `shared_link_access` | `Enterprise configuration item with string value` | No | The selected option for who has access to shared links. |
| `shared_link_default_access` | `Enterprise configuration item with string value` | No | The selected option for the access level of shared links. |
| `shared_link_default_permissions_selected` | `Enterprise configuration item` | No | The permissions selected for shared links for each type. |
| `is_open_custom_urls_disabled` | `Enterprise configuration item with boolean value` | No | Disables custom shared link URLs for public access. |
| `is_custom_domain_hidden_in_shared_link` | `Enterprise configuration item with boolean value` | No | Hides the custom domain in shared links. |
| `collaboration_permissions` | `Enterprise configuration item` | No | |
| `default_collaboration_role` | `Enterprise configuration item with string value` | No | The current default collaboration role. |
| `is_invite_privilege_restricted` | `Enterprise configuration item with boolean value` | No | Restrict invites to only admin, folder owners, and co-owners. |
| `collaboration_restrictions` | `Enterprise configuration item` | No | The collaboration restrictions for the enterprise. |
| `is_collaborator_invite_links_disabled` | `Enterprise configuration item with boolean value` | No | Disables users to invite collaborators using invite links. |
| `is_invite_group_collaborator_disabled` | `Enterprise configuration item with boolean value` | No | Disables users to invite group collaborators. |
| `is_ownership_transfer_restricted` | `Enterprise configuration item with boolean value` | No | Prevents ownership transfer to external users. |
| `external_collaboration_status` | `Enterprise configuration item` | No | The external collaboration status. Possible values: `enable_external_collaboration`, `limit_collaboration_to_allowlisted_domains`, `limit_collaboration_to_users_within_enterprise`. |
| `external_collaboration_allowlist_users` | `Enterprise configuration item` | No | The external collaboration allowlist users. |
| `is_watermarking_enterprise_feature_enabled` | `Enterprise configuration item with boolean value` | No | Enables watermarking enterprise feature. |
| `is_root_content_creation_restricted` | `Enterprise configuration item with boolean value` | No | Only admins can create and delete first-level folders, files, and bookmarks. |
| `is_tag_creation_restricted` | `Enterprise configuration item with boolean value` | No | Only selected users can create tags. |
| `tag_creation_restriction` | `Enterprise configuration item with string value` | No | The selected option for tag creation restriction. |
| `is_email_uploads_enabled` | `Enterprise configuration item with boolean value` | No | Enables email uploads. |
| `is_custom_settings_enabled` | `Enterprise configuration item with boolean value` | No | Enables custom settings. |
| `is_forms_login_required` | `Enterprise configuration item with boolean value` | No | Require uploaders to log in with a Box account for Forms. |
| `is_forms_branding_default_enabled` | `Enterprise configuration item with boolean value` | No | Company brand color and logo defaults to Logo for use on Brand Color for Forms. |
| `is_cc_free_trial_active` | `Enterprise configuration item with boolean value` | No | Indicates if the enterprise is on a free trial. |
| `is_file_request_editors_allowed` | `Enterprise configuration item with boolean value` | No | Indicates if editors are allowed for file requests feature. |
| `is_file_request_branding_default_enabled` | `Enterprise configuration item with boolean value` | No | Company brand color and logo defaults to Logo for use on Brand Color for File Requests. |
| `is_file_request_login_required` | `Enterprise configuration item with boolean value` | No | Require uploaders to log in with a Box account for File Requests. |
| `is_shared_links_expiration_enabled` | `Enterprise configuration item with boolean value` | No | Enables shared links expiration. |
| `shared_links_expiration_days` | `Enterprise configuration item with integer value` | No | The expiration time for shared links. |
| `is_public_shared_links_expiration_enabled` | `Enterprise configuration item with boolean value` | No | Enables public shared links expiration. |
| `public_shared_links_expiration_days` | `Enterprise configuration item with integer value` | No | The expiration time for public shared links. |
| `shared_expiration_target` | `Enterprise configuration item with string value` | No | The selected option of types for applying shared link expiration. |
| `is_shared_links_expiration_notification_enabled` | `Enterprise configuration item with boolean value` | No | Enables shared links expiration notification. |
| `shared_links_expiration_notification_days` | `Enterprise configuration item with integer value` | No | The number of days before expiration to notify users. |
| `is_shared_links_expiration_notification_prevented` | `Enterprise configuration item with boolean value` | No | Prevents users from disabling shared links expiration notification. |
| `is_auto_delete_enabled` | `Enterprise configuration item with boolean value` | No | Enables auto delete. |
| `auto_delete_days` | `Enterprise configuration item with integer value` | No | The number of days before auto delete. |
| `is_auto_delete_expiration_modification_prevented` | `Enterprise configuration item with boolean value` | No | Prevents users from modifying auto delete expiration. |
| `auto_delete_target` | `Enterprise configuration item with string value` | No | The selected option of types for applying auto delete. |
| `is_collaboration_expiration_enabled` | `Enterprise configuration item with boolean value` | No | Enables collaboration expiration. |
| `collaboration_expiration_days` | `Enterprise configuration item with integer value` | No | The number of days before collaboration expiration. |
| `is_collaboration_expiration_modification_prevented` | `Enterprise configuration item with boolean value` | No | Prevents users from modifying collaboration expiration. |
| `is_collaboration_expiration_notification_enabled` | `Enterprise configuration item with boolean value` | No | Enables collaboration expiration notification. |
| `collaboration_expiration_target` | `Enterprise configuration item with string value` | No | The selected option of types for applying collaboration expiration. |
| `trash_auto_clear_time` | `Enterprise configuration item with integer value` | No | The time before items are permanently deleted from the trash in seconds. |
| `permanent_deletion_access` | `Enterprise configuration item with string value` | No | The selected option for who can delete items from the trash. |
| `permanent_deletion_allowlist_users` | `Enterprise configuration item` | No | The allowlist users for permanently deleting items from the trash. |
```json Example theme={null}
{
"enterprise_feature_settings": [
{
"is_used": true,
"value": {
"id": "eyJlbnRlcnByaXNlSWQiOiIxMTExNDQyNzY3IiwiZmVhdHVyZUlkIjoiY2FudmFzIn0=",
"feature": {
"id": "canvas"
},
"state": "enabled",
"can_configure": true,
"is_configured": true,
"allowlist": [
{
"type": "user",
"id": "12345"
}
],
"denylist": [
{
"type": "user",
"id": "12345"
}
]
}
}
],
"sharing_item_type": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_company_definition": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_access": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_default_access": {
"is_used": true,
"value": "value of configuration"
},
"shared_link_default_permissions_selected": {
"is_used": true,
"value": {
"shared_links_option": "settings_shared_link_preview",
"default_shared_link_type": "settings_default_shared_link_preview",
"notes_shared_link_option": "settings_notes_option_to_edit",
"default_notes_shared_link_type": "settings_default_notes_shared_link_to_edit"
}
},
"is_open_custom_urls_disabled": {
"is_used": true,
"value": true
},
"is_custom_domain_hidden_in_shared_link": {
"is_used": true,
"value": true
},
"collaboration_permissions": {
"is_used": true,
"value": {
"is_co_owner_role_enabled": true,
"is_editor_role_enabled": true,
"is_previewer_role_enabled": true,
"is_previewer_uploader_role_enabled": true,
"is_uploader_role_enabled": true,
"is_viewer_role_enabled": true,
"is_viewer_uploader_role_enabled": true
}
},
"default_collaboration_role": {
"is_used": true,
"value": "value of configuration"
},
"is_invite_privilege_restricted": {
"is_used": true,
"value": true
},
"collaboration_restrictions": {
"is_used": true,
"value": [
"internal"
]
},
"is_collaborator_invite_links_disabled": {
"is_used": true,
"value": true
},
"is_invite_group_collaborator_disabled": {
"is_used": true,
"value": true
},
"is_ownership_transfer_restricted": {
"is_used": true,
"value": true
},
"external_collaboration_status": {
"is_used": true,
"value": "enable_external_collaboration"
},
"external_collaboration_allowlist_users": {
"is_used": true,
"value": [
{
"id": 1234,
"name": "John Doe",
"email": "johndoe@box.com"
}
]
},
"is_watermarking_enterprise_feature_enabled": {
"is_used": true,
"value": true
},
"is_root_content_creation_restricted": {
"is_used": true,
"value": true
},
"is_tag_creation_restricted": {
"is_used": true,
"value": true
},
"tag_creation_restriction": {
"is_used": true,
"value": "value of configuration"
},
"is_email_uploads_enabled": {
"is_used": true,
"value": true
},
"is_custom_settings_enabled": {
"is_used": true,
"value": true
},
"is_forms_login_required": {
"is_used": true,
"value": true
},
"is_forms_branding_default_enabled": {
"is_used": true,
"value": true
},
"is_cc_free_trial_active": {
"is_used": true,
"value": true
},
"is_file_request_editors_allowed": {
"is_used": true,
"value": true
},
"is_file_request_branding_default_enabled": {
"is_used": true,
"value": true
},
"is_file_request_login_required": {
"is_used": true,
"value": true
},
"is_shared_links_expiration_enabled": {
"is_used": true,
"value": true
},
"shared_links_expiration_days": {
"is_used": true,
"value": 1234
},
"is_public_shared_links_expiration_enabled": {
"is_used": true,
"value": true
},
"public_shared_links_expiration_days": {
"is_used": true,
"value": 1234
},
"shared_expiration_target": {
"is_used": true,
"value": "value of configuration"
},
"is_shared_links_expiration_notification_enabled": {
"is_used": true,
"value": true
},
"shared_links_expiration_notification_days": {
"is_used": true,
"value": 1234
},
"is_shared_links_expiration_notification_prevented": {
"is_used": true,
"value": true
},
"is_auto_delete_enabled": {
"is_used": true,
"value": true
},
"auto_delete_days": {
"is_used": true,
"value": 1234
},
"is_auto_delete_expiration_modification_prevented": {
"is_used": true,
"value": true
},
"auto_delete_target": {
"is_used": true,
"value": "value of configuration"
},
"is_collaboration_expiration_enabled": {
"is_used": true,
"value": true
},
"collaboration_expiration_days": {
"is_used": true,
"value": 1234
},
"is_collaboration_expiration_modification_prevented": {
"is_used": true,
"value": true
},
"is_collaboration_expiration_notification_enabled": {
"is_used": true,
"value": true
},
"collaboration_expiration_target": {
"is_used": true,
"value": "value of configuration"
},
"trash_auto_clear_time": {
"is_used": true,
"value": 1234
},
"permanent_deletion_access": {
"is_used": true,
"value": "value of configuration"
},
"permanent_deletion_allowlist_users": {
"is_used": true,
"value": [
{
"id": 1234,
"name": "John Doe",
"email": "johndoe@box.com"
}
]
}
}
```
## Enterprise configuration security
The enterprise configuration for the security category.
| Property | Type | Required | Description |
| ----------------------------------------------------- | -------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `is_managed_user_signup_enabled` | `Enterprise configuration item with boolean value` | No | Determines if users are allowed to sign up on their own. |
| `is_managed_user_signup_notification_enabled` | `Enterprise configuration item with boolean value` | No | Determines if users must sign up with your corporate email. |
| `is_managed_user_signup_corporate_email_enabled` | `Enterprise configuration item with boolean value` | No | When enabled, admin are emailed when new users are added. |
| `is_new_user_notification_daily_digest_enabled` | `Enterprise configuration item with boolean value` | No | Depends on `is_managed_user_signup_corporate_email_enabled`. A true value represents `In daily summary emails`. A false value represents `Immediately`. |
| `is_managed_user_email_change_disabled` | `Enterprise configuration item with boolean value` | No | When enabled, prevents users from changing their primary email address. |
| `is_multi_factor_auth_required` | `Enterprise configuration item with boolean value` | No | Determines if multi-factor authentication is required for all managed users. |
| `is_weak_password_prevention_enabled` | `Enterprise configuration item with boolean value` | No | When enabled, prevents common words / email address to be used in a password. |
| `is_password_leak_detection_enabled` | `Enterprise configuration item with boolean value` | No | Enables exposed password detection. |
| `last_password_reset_at` | `Enterprise configuration item` | No | |
| `is_password_request_notification_enabled` | `Enterprise configuration item with boolean value` | No | When enabled, admins are notified when users request a forget password email. |
| `is_password_change_notification_enabled` | `Enterprise configuration item with boolean value` | No | When enabled, admins are notified when users change passwords in Settings. |
| `is_strong_password_for_ext_collab_enabled` | `Enterprise configuration item with boolean value` | No | Requires strong passwords for External Collaborators. |
| `is_managed_user_migration_disabled` | `Enterprise configuration item with boolean value` | No | Disables users from being migrated in or out of the enterprise. |
| `join_link` | `Enterprise configuration item with string value` | No | Join url for self sign up. Depends on `is_managed_user_signup_enabled`. Applies if `join_url` is not used. |
| `join_url` | `Enterprise configuration item with string value` | No | Join url for self sign up. Depends on `is_managed_user_signup_enabled`. Applies if `join_link` is not used. |
| `failed_login_attempts_to_trigger_admin_notification` | `Enterprise configuration item with integer value` | No | Number of failed login attempts before the primary admin is notified. |
| `password_min_length` | `Enterprise configuration item with integer value` | No | Minimum number of characters required for passwords. |
| `password_min_uppercase_characters` | `Enterprise configuration item with integer value` | No | Minimum number of upper case characters required in passwords. |
| `password_min_numeric_characters` | `Enterprise configuration item with integer value` | No | Minimum number of numbers required in passwords. |
| `password_min_special_characters` | `Enterprise configuration item with integer value` | No | Minimum number of symbols required in passwords. |
| `password_reset_frequency` | `Enterprise configuration item with string value` | No | Determines if users must reset their passwords every specified time period. |
| `previous_password_reuse_limit` | `Enterprise configuration item with string value` | No | Number of previous passwords users are prevented from using. |
| `session_duration` | `Enterprise configuration item with string value` | No | Value indicating time from the last activity a user can remain logged in without activity before being logged out. |
| `external_collab_multi_factor_auth_settings` | `Enterprise configuration item` | No | External Collaborators multi-factor authentication settings. |
| `keysafe` | `Enterprise configuration item` | No | |
| `is_custom_session_duration_enabled` | `Enterprise configuration item with boolean value` | No | Enables custom session duration for select users. |
| `custom_session_duration_value` | `Enterprise configuration item with string value` | No | Value indicating duration users from specified groups can remain logged in without activity before being logged out. |
| `custom_session_duration_groups` | `Enterprise configuration item` | No | Groups for custom session duration. |
| `multi_factor_auth_type` | `Enterprise configuration item with string value` | No | Managed Users multi-factor authentication requirement method type. |
| `enforced_mfa_frequency` | `Enterprise configuration item` | No | Managed Users multi-factor authentication frequency. The default authentication frequency is set to 30 days, with authentication time calculated from the most recent successful MFA login. |
```json Example theme={null}
{
"is_managed_user_signup_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_signup_notification_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_signup_corporate_email_enabled": {
"is_used": true,
"value": true
},
"is_new_user_notification_daily_digest_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_email_change_disabled": {
"is_used": true,
"value": true
},
"is_multi_factor_auth_required": {
"is_used": true,
"value": true
},
"is_weak_password_prevention_enabled": {
"is_used": true,
"value": true
},
"is_password_leak_detection_enabled": {
"is_used": true,
"value": true
},
"last_password_reset_at": {
"is_used": true,
"value": "2012-12-12T10:53:43-08:00"
},
"is_password_request_notification_enabled": {
"is_used": true,
"value": true
},
"is_password_change_notification_enabled": {
"is_used": true,
"value": true
},
"is_strong_password_for_ext_collab_enabled": {
"is_used": true,
"value": true
},
"is_managed_user_migration_disabled": {
"is_used": true,
"value": true
},
"join_link": {
"is_used": true,
"value": "value of configuration"
},
"join_url": {
"is_used": true,
"value": "value of configuration"
},
"failed_login_attempts_to_trigger_admin_notification": {
"is_used": true,
"value": 1234
},
"password_min_length": {
"is_used": true,
"value": 1234
},
"password_min_uppercase_characters": {
"is_used": true,
"value": 1234
},
"password_min_numeric_characters": {
"is_used": true,
"value": 1234
},
"password_min_special_characters": {
"is_used": true,
"value": 1234
},
"password_reset_frequency": {
"is_used": true,
"value": "value of configuration"
},
"previous_password_reuse_limit": {
"is_used": true,
"value": "value of configuration"
},
"session_duration": {
"is_used": true,
"value": "value of configuration"
},
"external_collab_multi_factor_auth_settings": {
"is_used": true,
"value": {
"denylist_domains": [
"example.com"
],
"denylist_emails": [
"spam@example.com"
],
"allowlist_domains": [
"example.com"
],
"allowlist_emails": [
"mail@example.com"
],
"state": "enabled",
"scheduled_status": "inprogress",
"scheduled_at": "2012-12-12T10:53:43-08:00",
"factor_type_settings": "totp"
}
},
"keysafe": {
"is_used": true,
"value": {
"keysafe_enabled": true,
"cloud_provider": "",
"key_id": "1234",
"account_id": "1234",
"location_id": "1234",
"project_id": "1234",
"keyring_id": "1234"
}
},
"is_custom_session_duration_enabled": {
"is_used": true,
"value": true
},
"custom_session_duration_value": {
"is_used": true,
"value": "value of configuration"
},
"custom_session_duration_groups": {
"is_used": true,
"value": [
{
"id": "1234",
"name": "Group Name"
}
]
},
"multi_factor_auth_type": {
"is_used": true,
"value": "value of configuration"
},
"enforced_mfa_frequency": {
"is_used": true,
"value": {
"days": 30,
"hours": 24
}
}
}
```
## Enterprise configuration shield
The enterprise configuration for the shield category.
| Property | Type | Required | Description |
| -------------- | --------------------------- | -------- | -------------------------------------------------- |
| `shield_rules` | array of `Shield rule item` | No | The shield rules configuration for the enterprise. |
```json Example theme={null}
{
"shield_rules": [
{
"id": "1234567890",
"type": "shield_rule",
"rule_category": "Malicious Content",
"name": "Block malicious files",
"description": "Blocks files identified as malicious content",
"priority": "high",
"created_at": "2012-12-12T10:53:43-08:00",
"modified_at": "2012-12-12T10:53:43-08:00"
}
]
}
```
## Enterprise configuration user settings
The enterprise configuration for the user settings category.
| Property | Type | Required | Description |
| ---------------------------------------------------- | -------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `enterprise_feature_settings` | array of `Enterprise feature settings item` | No | |
| `user_invites_expiration_time_frame` | `Enterprise configuration item with string value` | No | Determines the time frame for any unaccepted invitation to your Box enterprise account to expire. |
| `is_username_change_restricted` | `Enterprise configuration item with boolean value` | No | Determines if users are restricted from changing their username in Account Settings. |
| `is_box_sync_restricted_for_new_users` | `Enterprise configuration item with boolean value` | No | Determines if Box Sync is restricted for new users. |
| `is_view_all_users_enabled_for_new_users` | `Enterprise configuration item with boolean value` | No | Determines if new users can see all managed users in their contacts when inviting collaborators. |
| `is_device_limit_exemption_enabled_for_new_users` | `Enterprise configuration item with boolean value` | No | Determines if new users are exempt from the maximum number of devices specified in the Device Protection settings. |
| `is_external_collaboration_restricted_for_new_users` | `Enterprise configuration item with boolean value` | No | Determines if new users will not be allowed to create folders that can have external collaborators. |
| `is_unlimited_storage_enabled_for_new_users` | `Enterprise configuration item with boolean value` | No | Determines if new users are given unlimited storage. |
| `new_user_default_storage_limit` | `Enterprise configuration item with integer value` | No | Determines the default storage limit for new users. Does not apply if `is_unlimited_storage_enabled_for_new_users` is true. |
| `new_user_default_timezone` | `Enterprise configuration item with string value` | No | Determines the default timezone for new users. |
| `new_user_default_language` | `Enterprise configuration item with string value` | No | Determines the default language for new users. |
| `is_enterprise_sso_required` | `Enterprise configuration item with boolean value` | No | Value indicating if SSO is required for all users. |
| `is_enterprise_sso_in_testing` | `Enterprise configuration item with boolean value` | No | Value indicating if SSO is in testing mode for all users. |
| `is_sso_auto_add_groups_enabled` | `Enterprise configuration item with boolean value` | No | Determines if any new groups received for a user upon login through SSO but not present in the enterprise will be auto added to the enterprise. |
| `is_sso_auto_add_user_to_groups_enabled` | `Enterprise configuration item with boolean value` | No | Determines if a user will be added to enterprise groups received upon user login through SSO. |
| `is_sso_auto_remove_user_from_groups_enabled` | `Enterprise configuration item with boolean value` | No | Determines if a user will be removed from enterprise groups upon user login through SSO. |
| `user_tracking_codes` | `Enterprise configuration item` | No | Properties that are assigned as additional values to users, like employee ID or region. |
| `number_of_user_tracking_codes_remaining` | `Enterprise configuration item with integer value` | No | The remaining number of `user_tracking_codes` that can be created. |
| `is_instant_login_restricted` | `Enterprise configuration item with boolean value` | No | Determines if users are restricted from granting (limited) access for Box Support for troubleshooting. |
```json Example theme={null}
{
"enterprise_feature_settings": [
{
"is_used": true,
"value": {
"id": "eyJlbnRlcnByaXNlSWQiOiIxMTExNDQyNzY3IiwiZmVhdHVyZUlkIjoiY2FudmFzIn0=",
"feature": {
"id": "canvas"
},
"state": "enabled",
"can_configure": true,
"is_configured": true,
"allowlist": [
{
"type": "user",
"id": "12345"
}
],
"denylist": [
{
"type": "user",
"id": "12345"
}
]
}
}
],
"user_invites_expiration_time_frame": {
"is_used": true,
"value": "7 days"
},
"is_username_change_restricted": {
"is_used": true,
"value": true
},
"is_box_sync_restricted_for_new_users": {
"is_used": true,
"value": true
},
"is_view_all_users_enabled_for_new_users": {
"is_used": true,
"value": true
},
"is_device_limit_exemption_enabled_for_new_users": {
"is_used": true,
"value": true
},
"is_external_collaboration_restricted_for_new_users": {
"is_used": true,
"value": true
},
"is_unlimited_storage_enabled_for_new_users": {
"is_used": true,
"value": true
},
"new_user_default_storage_limit": {
"is_used": true,
"value": 1234
},
"new_user_default_timezone": {
"is_used": true,
"value": "GMT-05:00 America\\/Chicago CDT"
},
"new_user_default_language": {
"is_used": true,
"value": "English (US)"
},
"is_enterprise_sso_required": {
"is_used": true,
"value": true
},
"is_enterprise_sso_in_testing": {
"is_used": true,
"value": true
},
"is_sso_auto_add_groups_enabled": {
"is_used": true,
"value": true
},
"is_sso_auto_add_user_to_groups_enabled": {
"is_used": true,
"value": true
},
"is_sso_auto_remove_user_from_groups_enabled": {
"is_used": true,
"value": true
},
"user_tracking_codes": {
"is_used": true,
"value": [
{
"id": 1234,
"name": "Employee ID"
}
]
},
"number_of_user_tracking_codes_remaining": {
"is_used": true,
"value": 1234
},
"is_instant_login_restricted": {
"is_used": true,
"value": true
}
}
```