Skip to main content
2025-12-11

New developer documentation site (beta)

We are exited to announce the beta launch of the new Box developer documentation site. This release provides access to the redesigned, AI-first, purpose-built developer experience platform.

What’s included in this launch

New design aligned with developer workflows:
  • Refreshed homepage
  • Intuitive landing pages
  • Interactive API testing experience
  • Improved readability and accessibility:
    • Enhanced navigation
    • Clear, responsive book structure with global and single-page tables of contents
    • Light and dark modes
AI-first functionality:
  • AI-powered search with generative answers and aggregated results from across Box sites
  • Contextual menu options to integrate with leading AI tools and copy pages as Markdown
  • Box Dev Docs MCP server

Developer impact

The new site delivers our up-to-date developer documentation in an entirely new experience. Some UX features are still in their beta shape and will continue to be refined in the next few weeks, so you may encounter occasional changes or improvements as we gather feedback and iterate. We encourage you to engage with the new functionality and share your comments.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-11-27

Box AI API — new AI models available and default models update

The list of available AI models has been recently updated with the following models:Additionally, default AI models have been updated for Box AI features:
  • Gemini 2.5 Pro is now the default model for Box AI Enhanced Extract.
  • Gemini 2.5 Flash is now the default model for Box AI Standard Extract.
  • OpenAI GPT-5 is now the default model for Box AI Advanced Agent for Hubs, Documents, and Notes Q&A.
  • OpenAI GPT-5 mini is now the default model for Box AI for Hubs, Documents, and Notes Q&A.
Note: Models offered in Preview mode have not been fully performance-tested at scale and are provided on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-11-20

Box iOS SDK 6.1.0 released

New Features and Enhancements

  • boxsdkgen: Support GET enterprise configuration API (box/box-openapi#559) (#1190) (c91bb4f)
  • boxsdkgen: Support Archive API (box/box-openapi#563) (#1237) (07aaf3a)
2025-11-20
Box iOS SDK 10.1.0 released

New Features and Enhancements

2025-11-20

Box CLI v4.5.0 released

New Features and Enhancements

  • support auto update using Github releases (#603) (2460e1b)

Bug Fixes

  • update dependencies to fix tmp vulnerability (#600) (7e270eb)
2025-11-19

Box Windows SDK v6.1.0 released

New Features and Enhancements:

  • boxsdkgen: Support Archive API (box/box-codegen#865) (#1270) (307a5d4)
  • boxsdkgen: Support GET enterprise configuration API (box/box-openapi#559) (#1212) (0d97d4d)
  • boxsdkgen: Use generated RetryStrategy for retrying requests (box/box-codegen#872) (#1227) (5b42a3e)
2025-11-19

Box Windows SDK v10.2.0 released

New Features and Enhancements

  • Support Archive API (box/box-codegen#865) (#1266) (bca0473)
  • Support GET enterprise configuration API (box/box-openapi#559) (#1198) (426aaed)
  • Include pdb files when packing .net root project (box/box-codegen#859) (#1169) (8b7e7c8)
  • Use generated RetryStrategy for retrying requests (box/box-codegen#872) (#1232) (5567fef)
2025-11-19

Box Python SDK v10.1.0 released

New Features and Enhancements

2025-11-12

Box Node SDK v4.1.1 released

Bug Fixes

  • boxsdkgen: Fix error propagation and empty fetch response handling in node SDK (box/box-codegen#883) (#1196) (9615a34)
2025-11-10
Box Node SDK v10.1.0 released

Bug Fixes

New Features and Enhancements

2025-11-07

Box UI Elements v25.3.0 released

25.3.0 (2025-11-07)

Features

  • deps: Upgrade blueprint-web to 12.93.5 (#4362) (84aaf2f)
  • metadata: enable multilevel taxonomy field filter in preview (#4354) (4851c37)
2025-11-04

Box UI Elements v25.2.0 released

25.2.0 (2025-11-04)

Bug Fixes

Features

  • api: respect hidden collaborators (#4346) (955e6cb)
  • content-explorer: Disable selection while editing (#4317) (c08d9b5)
  • content-sharing: convert api response for collabs (#4322) (6937b60)
  • content-sharing: Create contact service getContactByEmail (#4342) (05b50cd)
  • content-sharing: Create contact service getContacts (#4338) (8ae6ccc)
  • content-sharing: Create contact service getContactsAvatarUrls (#4345) (6f9260b)
  • content-sharing: Create sharing service changeSharedLinkPermission (#4332) (e64a61b)
  • content-sharing: Create sharing service sendInvitations (#4344) (d497350)
  • content-sharing: Define sharing service for shared link and access (#4340) (2f7185d)
  • content-sharing: Handle error when fetch init data failed (#4350) (f0c9efd)
  • content-sharing: Render notification for sendInvitations (#4347) (051bd7c)
  • content-sharing: Sharing service updateSharedLink (#4336) (b39a482)
  • deps: upgrade package dependencies (#4359) (2f025e3)

Reverts

  • “feat(content-sidebar): implement for custom sidebar panels (#… (#4320) (230f417), closes #4239
2025-10-23

Box AI API — new AI models available and default model update

The list of available AI models has been recently updated with the following models:Additionally, OpenAI GPT 5 is now the default model for Box AI (Box AI for Hubs, Box AI for Documents, and Box AI for Notes Q&A).Note: Models offered in Preview mode have not been fully performance-tested at scale and are provided on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-10-23

Box Windows SDK v6.0.0 released

Introducing a new major version of Box Windows SDK V2 v6 that includes two namespaces - the manually maintained namespace and the generated namespace. The coexisting namespaces provide easier access to the latest Box API features and support gradual migration to the standalone generated namespace.

Breaking Changes

  • With v6 of Box Windows SDK V2, support for .NET 6 has been dropped. We follow the official .NET Release Lifecycle. Since November 12, 2024, .NET 6 is no longer officially supported. While it may still be possible to compile and use this SDK under .NET 6, we do not provide support for issues encountered on that version.
For more information about migrating to v6 visit v5 to v6 migration guide

What’s New in v6

With this SDK version, alongside the existing Box.V2 namespace, we’re introducing a new Box.Sdk.Gen namespace, which gives you access to:
  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version allows you to gradually migrate your code base to the Box.Sdk.Gen namespace. The key differences between the namespaces are documented in the namespace migration guide.Ultimately, we recommend to migrate to v10 which includes only the generated namespace Box.Sdk.Gen. To migrate from v6 to v10 follow this migration guide.For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.
2025-10-23

Box SDKs major version

Introducing a new major release of Box SDKs that includes two packages — the manually maintained package and the generated package. The coexisting packages provide easier access to the latest Box API features and support gradual migration to the standalone generated package.

Overview

To facilitate this migration process, there are two actively maintained major Box core SDK versions:
  • The latest major version that follows sequential versioning and includes the manually maintained package and the generated one. This SDK version enables leveraging coexisting packages at the same time, and serves as a transition phase. Support for the consolidated version of each Box core SDK will continue in 2027.
  • v10 that includes only the generated package, a consistent version number across all Box SDK artifacts.

Additional information and migration guides

For additional information on recommended actions and migration guides, visit Box SDK versioning strategy page.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum or report issues directly in the individual Box SDK repositories on GitHub.
2025-10-23

Box Python SDK v4.0.0 released

Introducing a new major version of Box Python SDK v4 that includes two packages — the manually maintained boxsdk package and the generated box_sdk_gen package. The coexisting packages provide easier access to the latest Box API features and support gradual migration to the standalone generated package.

Breaking Changes

  • v4 of Box Python SDK supports Python versions: 3.8+. Compared to v3, Python 3.6 and 3.7 are no longer supported.
For more information about migrating to v4 visit v3 to v4 migration guide

What’s New in v4

With this SDK version, alongside the existing boxsdk package, we’re introducing a new box_sdk_gen package, which gives you access to:
  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version allows you to gradually migrate your code base to the box_sdk_gen package. The key differences between the packages are documented in the package migration guide.Ultimately, we recommend to migrate to v10 which includes only the generated box_sdk_gen package. To migrate from v4 to v10 follow this migration guide.For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.
2025-10-23

Box Node SDK v4.0.0 released

Introducing a new major version of Box Node SDK v4 that includes two modules — the manually maintained module and the generated module. The coexisting modules provide easier access to the latest Box API features and support gradual migration to the standalone generated module.

Breaking Changes

  • With v4 of Box Node SDK, support for Node version below 18 has been dropped. While it may still be possible to download and use this SDK under Node below 18, we do not provide support for issues encountered on that version.
  • We have updated the module export style in the manually maintained box-node-sdk module to support the ES module and be more consistent with the generated sdk-gen module. Classes in the manual SDK are now exported as default exports from their respective files. When importing with CommonJS (require), use .default to access the class (e.g., const BoxSDK = require('box-node-sdk').default;).
For more information about migrating to v4 visit v3 to v4 migration guide

What’s New in v4

With this SDK version, alongside the existing manually maintained module, we’re introducing a new generated sdk-gen module under box-node-sdk/sdk-gen import path, which gives you access to:
  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version allows you to gradually migrate your code base to the sdk-gen module. The key differences between the modules are documented in the module migration guide.Ultimately, we recommend to migrate to v10 which includes only the generated sdk-gen module. To migrate from v4 to v10 follow this migration guide.For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.
2025-10-23

Box Java SDK v5.0.0 released

Introducing a new major version of Box Java SDK v5 that includes two packages — the manually maintained com.box.sdk package and the generated com.box.sdkgen package. The coexisting packages provide easier access to the latest Box API features and support gradual migration to the standalone generated package.There are no breaking changes between v4 and v5 of Box Java SDK. For more information about migrating to v5 visit v4 to v5 migration guide

What’s New in v5

With this SDK version, alongside the existing com.box.sdk package, we’re introducing a new com.box.sdkgen package, which gives you access to:
  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version allows you to gradually migrate your code base to the com.box.sdkgen package. The key differences between the packages are documented in the package migration guide.Ultimately, we recommend to migrate to v10 which includes only the generated com.box.sdkgen package. To migrate from v5 to v10 follow this migration guide.For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.
2025-10-23

Box iOS SDK 6.0.0 released

Introducing a new major version of Box iOS SDK v6 that includes two modules — the manually maintained module and the generated module. The coexisting modules provide easier access to the latest Box API features and support gradual migration to the standalone generated module.

Breaking Changes

  • With v6 of Box iOS SDK, support for iOS 11.0, macOS 10.13, tvOS 11.0 and watchOS 4.0 has been dropped.
Starting with v6, the minimum supported versions are iOS 13.0, macOS 10.15, tvOS 13.0, and watchOS 6.0.This update aligns the SDK with current Apple development standards and is required to adopt the new features available in the BoxSdkGen module.For the latest submission and SDK toolchain requirements, see Apple’s SDK minimum requirements Apple Developer.For more information about migrating to v6 visit v5 to v6 migration guide.

What’s New in v6

With this SDK version, alongside the existing BoxSDK module, we’re introducing a new BoxSdkGen module, which gives you access to:
  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version allows you to gradually migrate your code base to the BoxSdkGen module. The key differences between the modules are documented in the module migration guide.Ultimately, we recommend to migrate to v10 which includes only the generated module BoxSdkGen. To migrate from v6 to v10 follow this migration guide.For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.
2025-10-21

Box CLI v4.4.1 released

Bug Fixes

  • Fix the --exempt-from-2fa flag in create and update users commands (#598) (8f897fe)
2025-10-14

Box CLI v4.4.0 released

New Features and Enhancements

  • Support update users notification email (#596) (49356f4)
2025-10-06

Box Windows SDK v10.1.0 released

Bug Fixes

  • Allow flexible key-value data in AiExtractResponse.answer and Event.additionalDetails (box/box-openapi#556) (#1147) (c41a444)
  • Make role parameter of update collaboration optional (box/box-openapi#557) (#1156) (8247918)

New Features and Enhancements

  • Handle Dictionary with object values deserialization (box/box-codegen#850) (#1144) (611b474)
2025-10-06

Box Python SDK v10.0.1 released

Bug Fixes

  • Allow flexible key-value data in AiExtractResponse.answer and Event.additionalDetails (box/box-openapi#556) (#1084) (f63cffe)
  • Make role parameter of update collaboration optional (box/box-openapi#557) (#1093) (5c21907)
2025-10-06
Box Node SDK v10.0.1 released

Bug Fixes

  • Allow flexible key-value data in AiExtractResponse.answer and Event.additionalDetails (box/box-openapi#556) (#1051) (70a2275)
  • Make role parameter of update collaboration optional (box/box-openapi#557) (#1068) (3992171)
  • Relax JSON deserialization guard by removing strict content-type check (box/box-codegen#844) (#1033) (1eb2c32)
2025-10-06

Box Java SDK v10.1.0 released

Bug Fixes

  • Allow flexible key-value data in AiExtractResponse.answer and Event.additionalDetails (box/box-openapi#556) (#1470) (e215a5f)
  • Make role parameter of update collaboration optional (box/box-openapi#557) (#1479) (6896386)

New Features and Enhancements

2025-10-06
Box iOS SDK 10.0.1 released

Bug Fixes

  • Allow flexible key-value data in AiExtractResponse.answer and Event.additionalDetails (box/box-openapi#556) (#1128) (3e9a78c)
  • Make role parameter of update collaboration optional (box/box-openapi#557) (#1138) (3fc5dc9)
2025-10-03

Box Java SDK v4.16.4 released

Bug Fixes

2025-10-01

Salesforce Developer Toolkit updates

The developer guides for the Salesforce Developer Toolkit have been updated to include:
2025-10-01

Box UI Elements v25.1.0 released

25.1.0 (2025-10-01)

Bug Fixes

  • i18n: update translations (#4298) (86df699)
  • security-cloud-game: Use nodeRef in DragCloud for React 19 (#4286) (ee8cba8)

Features

  • content-sharing: Convert Content Sharing V2 API Response (#4285) (6730ffe)
  • content-sidebar: handle success event for creating metadata instance (#4284) (371c1a9)
  • content-sidebar: implement for custom sidebar panels (#4239) (750737c)
  • item-properties: Add files count for folder in item properties (#4283) (f12340a)
  • video-annotations: sidebar support for video annotations (#4318) (aa5fc16)

Reverts

  • “chore(mergify): update circleci and mergify configuration (#4… (#4296) (b915e45), closes #4295
2025-09-30

Box AI API - AWS Claude 4.5 Sonnet now available

The list of available AI models has been recently updated with AWS Claude 4.5 Sonnet.Models offered in Preview mode have not been fully performance-tested at scale and are made available on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-09-29

Box CLI v4.3.1 released

Bug Fixes

  • Fix multi item mode in ai:ask command (#593) (5081d43)
2025-09-26

Box UI Elements v25.0.0 released

25.0.0 (2025-09-26)

Bug Fixes

Features

  • classification: AppliedByAiClassificationReason card to support empty reason (#4279) (cb04234)
  • classification: support AI reasoning and new applied by labels (#4271) (681bace)
  • content-sharing: Create ContentSharingV2 component (#4282) (ef49c77)
  • metadata-view: bump metadata view version (#4287) (f5887d7)
  • metadata-view: update blueprint web version (#4288) (6d599a3)
  • timestamped-comments: enable timestamp handling in sidebar (#4275) (7f9defa), closes #4226 #4230 #4274
  • timestamped-comments: timestamped comments editor updates (#4244) (6e1bd80), closes #4226 #4230

BREAKING CHANGES

  • common: Wrapped component of makeDroppable must have ref prop, for example with React.forwardRef
  • fix: Clean up tests
2025-09-05

Metadata view v2 in Content Explorer

We introduced v2 of the metadata view in the Box Content Explorer UI element. It’s a ground-up redesign of the original version, introducing a streamlined interface tailored for metadata-driven workflows.

Key features

  • filtering and editing interfaces with dedicated UI for each metadata field type,
  • flexible display options with list and grid views,
  • pagination support.

Migration from v1 to v2

The v1 of the metadata view Content Explorer has reached end of support and it will no longer receive bug fixes or new features. We recommend to migrate to the new v2 metadata view. See the migration guide for a detailed instruction.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-09-17
Box Windows SDK v10.0.0 released
Introducing Box SDK v10, a major release designed to elevate your developer experience and streamline integration with Box Content Cloud. Currently available as a separate sdk-gen branch, v10 will ultimately become the main branch.

Breaking Changes

  • This SDK version is auto-generated and introduces a new interface for all methods. Extensive documentation is available here.

What’s New in v10

  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version includes the Box Next Generation SDK artifact, previously developed in parallel to core Box SDKs. To facilitate migration and provide access to the newest features, we’ll soon release an additional major version combining both artifacts. Migration to v10 includes breaking changes, please review the migration guide for details. For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.

What’s New Compared to Dotnet SDK Gen v1.12.0

⚠ BREAKING CHANGES

Bug Fixes

New Features and Enhancements

For more details check migration guide from box-dotnet-sdk-gen v1 to box-windows-sdk-v2 v10.
2025-09-17

Box SDKs v10

Introducing Box SDKs v10, a major release designed to elevate your developer experience and streamline integration with Box Content Cloud. Currently available as a separate branch for each SDK, v10 will ultimately become the main branch.What’s new in v10:
  • Full API support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API updates — Our new auto-generation approach enables Box API additions within days, ensuring that you can leverage the most up-to-date features without delay.
  • Embedded documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced convenience methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.
This version includes the Box Next Generation SDK artifact, previously developed in parallel to Box core SDKs. To facilitate migration and provide access to the newest features, we’ll soon release an additional major version containing both artifacts. No immediate action required — If you’re using the current SDK version, your existing code will continue to work without changes. However, migrating to v10 includes breaking changes. For more information and migration guides, see the SDK versioning strategy document. Follow the developer changelog for future updates.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-09-17

Box Next Generation SDK deprecation

As of September 17, 2025 Box Next Generation SDKs are no longer supported as separate artifacts. Don’t worry, your existing code will continue to work without changes. You can still use your applications based on Box Next Generation SDKs with no impact, but you won’t receive new features, updates, or bug fixes.In keeping with industry best practices, we are consolidating the Box Next Generation SDKs and Box core SDKs into a single package for each programming language. This makes migration efforts much easier and allows seamless addition of new capabilities to existing applications still powered by Box core SDKs, which were maintained manually.All future development, including new features and updates for the Next Generation SDKs, will be delivered through Box core SDKs starting with version v10. Currently, v10 is available as a separate branch.For more information and migration guides, see the SDK versioning strategy document. Follow the developer changelog for future updates.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-09-17

Box Java SDK v10.0.0 released

Introducing Box SDK v10, a major release designed to elevate your developer experience and streamline integration with Box Content Cloud. Currently available as a separate sdk-gen branch, v10 will ultimately become the main branch.

Breaking Changes

  • This SDK version is auto-generated and introduces a new interface for all methods. Extensive documentation is available here.

What’s New in v10

  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version includes the Box Next Generation SDK artifact, previously developed in parallel to core Box SDKs. To facilitate migration and provide access to the newest features, we’ll soon release an additional major version combining both artifacts. Migration to v10 includes breaking changes, please review the migration guide for details. For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.

What’s New Compared to Java SDK Gen v0.8.1

⚠ BREAKING CHANGES

New Features and Enhancements

For more details check migration guide from box-java-sdk-gen v0 to box-java-sdk v10.
2025-09-17
Box iOS SDK 10.0.0 released
Introducing Box iOS SDK v10, a major release designed to elevate your developer experience and streamline integration with Box Content Cloud. Currently available as a separate sdk-gen branch, v10 will ultimately become the main branch.

Breaking Changes

  • This SDK version is auto-generated and introduces a new interface for all methods. Extensive documentation is available here.

What’s New in v10

  • Full API Support — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications.
  • Rapid API Updates — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay.
  • Embedded Documentation — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place.
  • Enhanced Convenience Methods — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more.

Important Notes

This version includes the Box Next Generation SDK artifact, previously developed in parallel to core Box SDKs. To facilitate migration and provide access to the newest features, we’ll soon release an additional major version combining both artifacts. Migration to v10 includes breaking changes, please review the migration guide for details. For more information, see the SDK versioning strategy document. Follow developer changelog for future updates.

What’s New Compared to Box Swift SDK Gen v0.6.3

New Features and Enhancements

For more details check migration guide from box-swift-sdk-gen v0 to box-ios-sdk v10.
2025-09-16
Box TypeScript SDK Generated v1.19.1 released

Bug Fixes

2025-09-05

Box UI Elements v24.0.0 released

24.0.0 (2025-09-05)

Bug Fixes

Features

  • add client version to element api calls (#4198) (468d6c1)
  • box-ai: Bump box-ai-content-answers version (#4233) (47cea9f)
  • classification: implement AppliedByAiClassificationReason (#4250) (e23fbf3)
  • content-explorer: Add initial filter values to Metadata View (#4225) (b68cd70)
  • metadata-instance-editor: remove ai agent selector split and fi… (#4226) (1f953c0)
  • metadata-view: Add Filtering (#4235) (2f5e42b)
  • metadata-view: bulk custom actions (#4227) (371ad5e)
  • metadata-view: default sortBy (#4232) (1a86aa5)
  • metadata-view: Implement metadata sidepanel (#4230) (4f89946)
  • metadata-view: Multi value display and onSave in metadata sidepanel (#4245) (7ddea1e)
  • metadata-view: pass-thru onSortChange (#4248) (1a8a59f)
  • router: withRouterIfEnabled (#4221) (f969170)
  • timestamped-comments: enabling time stamped video comments (#4228) (31b580d), closes #4226 #4230

BREAKING CHANGES

  • box-ai: isResetChatEnabled prop removed
2025-09-05

Box TypeScript SDK Generated v1.19.0 released

Bug Fixes

New Features and Enhancements

2025-09-05
Box Swift SDK Generated 0.6.3 released

New Features and Enhancements

2025-09-05

Box Python SDK Generated v1.17.0 released

New Features and Enhancements

2025-09-05

Box Dotnet SDK Generated v1.12.0 released

New Features and Enhancements

2025-08-26
Box TypeScript SDK Generated v1.18.1 released

Bug Fixes

  • correct import and export handling (box/box-codegen#801) (#738) (cea513f)
2025-08-26

Box TypeScript SDK Generated v1.18.0 released

Bug Fixes

  • bump form-data to 4.0.4 and types/node-fetch to 2.6.13 (box/box-codegen#808) (#735) (7330b95)
  • Fix serialization for MetadataFilterValue (box/box-codegen#800) (#727) (d046405)

New Features and Enhancements

  • Support event with long polling in Python and TS (box/box-codegen#757) (#712) (6f25fda)
2025-08-11

Bulk delete external users

You can now bulk delete up to 100 external user accounts through the public API.This job runs in the background, and sends a completion report when it’s finished.The report contains details identifying which user deletions succeeded and which failed.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-08-13
Box Swift SDK Generated 0.6.2 released

Bug Fixes

  • Fix downscope token to use retrieveToken method for token retrieval (box/box-codegen#731) (#459) (8992b32)
  • Fix parsing Date into query parameters (box/box-codegen#729) (#449) (1a95d0c)
  • Specify events next_stream_position property type as int64 (box/box-openapi#535) (#502) (795fe1c)

New Features and Enhancements

2025-08-12

Box UI Elements v23.4.0 released

23.4.0 (2025-08-12)

Bug Fixes

Features

  • boxai-sidebar: Add logic to render remote sidebar from prop (#4106) (7f8802a)
  • cascadepolicy: disable inputs if cascade policy exists (#4175) (b6d778c)
  • header-flyout: add opening animation (#4159) (3b417ba)
  • header-flyout: optionally allow header actions (#4164) (8f3ad6e)
  • mergify: update rule to require conversation resolution (#4142) (ef3291e)
  • metadata-editor and blueprint-web-assets package bump (#4137) (070ff74)
  • metadata-editor: expose advanced metadata extract agent props (#4128) (f59b0aa)
  • metadata-editor: expose custom agent in extractStructured payload (#4135) (076e719), closes #4102
  • metadata-editor: Metadata API adjustments (#4192) (6112967)
  • metadata-editor: package bump for new icons (#4195) (1506020)
  • metadata-instance-editor: add enhanced ai extract support (#4197) (540026a)
  • metadata-instance-editor: allow hydration of enhanced ai extract (#4217) (5a93a16)
  • metadata-view: Add MetadataView V2 (#4191) (c0ab1e7)
  • metadata-view: Add Subheader for Metadata View v2 (#4202) (ab12626)
  • metadata-view: Added Metadata V2 button (#4174) (d8ec9c7)
  • metadata-view: custom actions (#4215) (88a5187)
  • metadataeditor: enable ai folder extraction through API (#4102) (6ebec78)
  • metadataeditor: remove ai pricing notice (#4107) (4bd24bc)
  • notification-redesign: Add logic for use of BP icons (#4103) (7907136)
  • router: added router-less logic to VersionsSidebarContainer (#4209) (0f46866)
  • router: Merging NavButton functionality into SidebarNavButton (#4150) (814035d)
  • router: optional router in ActivitySidebar (#4199) (435c75a)
  • router: optional router in AddTaskButton (#4176) (90537b4)
  • router: optional router in NavRouter and withNavRouter (#4161) (7f9cad4)
  • router: optional router in SidebarNav, SidebarNavTablist (#4177) (d14e06e)
  • router: optional router in SidebarNavButton (#4156) (dc8af3b)
  • router: optional router in SidebarNavigation (#4194) (e25e0e1)
  • router: optional router in SidebarToggle (#4160) (12c9a3a)
  • router: optional router in StaticVersionSidebar and VersionsSid… (#4152) (a456f3d)
  • router: optional router in VersionsList (#4144) (15c5d8d)
  • router: optional router in withAnnotatorContext and withAnnotations (#4136) (d08545e)
  • router: optional router in withRouterAndRef hoc (#4162) (32b08b9)
  • router: optional router in withSidebarAnnotations (#4206) (782877d)
  • router: Removed router functionality from BackButton component (#4141) (f01364c)
  • upgrade blueprint packages (#4123) (c166d7d)
  • upgrade react-virtualized for react 19 support (#4157) (269f585)
  • uploads: add option to error on name conflicts (#4117) (463839e)
2025-08-07
Box TypeScript SDK Generated v1.17.1 released

Bug Fixes

  • Fix exports syntax when importing from lib (#700) (782a287)
2025-08-07

Box CLI v4.3.0 released

New Features and Enhancements

Bug Fixes

  • Fix support metadata query array (#583) (112db16)
  • Remove description flag from folders:create command (#587) (adca76b)
2025-08-05

Box TypeScript SDK Generated v1.17.0 released

Bug Fixes

  • Bump cypress to resolve CVE-2025-7783 in form-data (box/box-codegen#769) (#677) (077413e)

New Features and Enhancements

2025-08-05

Box Python SDK Generated v1.16.0 released

Bug Fixes

  • Specify events next_stream_position property type as int (box/box-openapi#535) (#644) (64069db)

New Features and Enhancements

  • Add AI spreadsheet processor (box/box-openapi#533) (#630) (6635757)
  • Add Archive Public API (box/box-openapi#540) (#651) (c36d1db)
  • Add new Hubs APIs and Hubs items API (box/box-openapi#538) (#645) (1daa3e8)
  • Add new property for network exception retry strategy (box/box-codegen#763) (#650) (13f9593)
  • Add new schema for Metadata Error (box/box-openapi#539) (#646) (49d7f34)
  • Allow injecting private key decryption mechanism for JWT (box/box-codegen#754) (#636) (4ea0af5)
  • Improve webhook validation checks (box/box-codegen#745) (#628) (f0ece63)
  • Support Hubs beta endpoints (box/box-openapi#531) (#622) (b5e95fe)
  • Support new tools in AI Studio (box/box-openapi#534) (#633) (ac76eb2)
2025-08-05

Box Dotnet SDK Generated v1.11.0 released

Bug Fixes

  • Fix downscope token to use retrieveToken method for token retrieval (box/box-codegen#731) (#492) (292360e)
  • Specify events next_stream_position property type as long (box/box-openapi#535) (#536) (da265bd)

New Features and Enhancements

2025-08-01

Box Hubs APIs

Box Hubs APIs enable you to programmatically create, manage, and collaborate on content hubs within your applications. Hubs provide a centralized space for organizing and sharing content across teams and projects.

What you can do with the Hubs APIs

The Hubs APIs consist of three main resource types that allow you to build comprehensive hub management functionality:
  1. Hubs
    • Create hub
    • Copy hub
    • Update hub information by ID
    • Delete hub
    • List all hubs
    • List all hubs for requesting enterprise
    • Get hub information by ID
  2. Hub Collaborations
    • Create hub collaboration
    • Update hub collaboration
    • Remove hub collaboration
    • Get hub collaborations
    • Get hub collaboration by collaboration ID
  3. Hub Items
    • Get hub items
    • Manage hub items
To learn more about using Box Hubs, visit the Box Hubs support documentation.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-07-29

Box Node SDK v3.8.2 released

Bug Fixes

  • Bump cypress/request to resolve CVE-2025-7783 in form-data (#904) (8e8d2da)
2025-07-27

Box AI API - Google Gemini 2.5 Pro now available, Gemini 2.5 Flash Preview and Pro Preview deprecated

The list of available AI models has been recently updated with Google Gemini 2.5 Pro.The following models have been deprecated:
  • Google Gemini 2.5 Flash Preview
  • Google Gemini 2.5 Pro Preview
For more information, see retired models.Models offered in Preview mode have not been fully performance-tested at scale and are made available on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-07-23

Box Java SDK v4.16.3 released

Bug Fixes

  • Fix compare message webhook message signature (#1315) (e2d407d)
  • Fix File Request Copy method to return valid data (#1320) (8392a43)
2025-06-24

Enhanced extract agent

Today we introduced the new enhanced extract agent powered by Gemini 2.5 Pro. It employs chain-of-thought processing to provide the best answer, but also to tell the developer the reason it believes this answer is the correct one.The enhanced extract agent:
  • Offers an improved key-value pair extraction from complex documents with higher accuracy.
  • Effortless access with Box UI: activate the feature with a single click.
  • Transforms unstructured data into meaningful metadata attached to files.
  • Enables faster insights and discovery using the Box Metadata search tool.
Go to the Autofilling Metadata in Templates section in our product documentation to learn more about its capabilities.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-06-24

AI Studio v2

With the release of the newest version of the AI Studio functionality, we introduced the enhancements listed below.
  • Users receive a notification in case of any issues with an agent directly in the AI Studio UI.
  • Agents are validated in real time. The ones that don’t pass validation are not visible for the users.
Admins can:
  • Control the suggested questions displayed when the user starts interacting with a custom AI agent.
  • See the details of a request and response of a LLM, for example the system prompt, model, custom instructions.
  • Control the parameters of a Box AI image processor in a custom agent. The parameters are necessary to ask a LLM about a specific image.
You can find more information in our API and product documentation.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-06-20

Box CLI v4.2.0 released

New Features and Enhancements

2025-06-12

Box TypeScript SDK Generated v1.16.0 released

Bug Fixes

  • Compute webhook signature with and without escaping the body (box/box-codegen#737) (#627) (6a21b8e)
  • Fix circular dependency in boxNetworkClient (box/box-codegen#708) (#591) (b383889)
  • Fix downscope token to use retrieveToken method for token retrieval (box/box-codegen#731) (#618) (90edb0c)
  • Fix slash escaping when calculating webhook signature (box/box-codegen#736) (#624) (a0307d0)
  • Handle list of strings in metadata filter (box/box-codegen#716) (#597) (979ff2c)
  • Improve file download to avoid storing content in memory (box/box-codegen#701) (#589) (513a15e)
  • Modify utility functions for browser (box/box-codegen#686) (#585) (7232170)
  • Use constant-time comparison for HMAC signatures (box/box-codegen#739) (#630) (efdcaaf)

New Features and Enhancements

  • Add AI agents warnings; allow for more types of metadata value (box/box-openapi#520) (#600) (a5a555f)
  • Add security settings properties on sign template schema (box/box-openapi#518) (#588) (dfd3e5f)
  • Add Shield Lists APIs (box/box-openapi#528) (#622) (be3af44)
  • Add support of IBM models to AI API (box/box-openapi#522) (#601) (b060b8c)
  • Increase max items for ai extract endpoints (box/box-openapi#525) (#602) (86c5d14)
  • Update legal holds and AI models (box/box-openapi#526) (#620) (de3df57)
2025-06-12

Box Python SDK Generated v1.15.0 released

Bug Fixes

  • Compute webhook signature with and without escaping the body (box/box-codegen#737) (#607) (e5118b8)
  • Fix downscope token to use retrieveToken method for token retrieval (box/box-codegen#731) (#598) (e492685)
  • Fix slash escaping when calculating webhook signature (box/box-codegen#736) (#603) (430b175)
  • Use constant-time comparison for HMAC signatures (box/box-codegen#739) (#610) (6f6660c)

New Features and Enhancements

  • Add AI agents warnings; allow for more types of metadata value (box/box-openapi#520) (#567) (86aa1cc)
  • Add Shield Lists APIs (box/box-openapi#528) (#601) (f980f65)
  • Add support of IBM models to AI API (box/box-openapi#522) (#568) (767547a)
  • Update legal holds and AI models (box/box-openapi#526) (#599) (d56228d)
2025-06-11

Box Node SDK v3.8.1 released

Bug Fixes

  • Use constant-time comparison for HMAC signatures (#893) (d819efe)
2025-06-02

Box Java SDK v4.16.2 released

Bug Fixes

  • Fix parsing downloadFileCount property for BoxZipDownloadStatus (50c2249)
2025-05-24

Box AI API - new AI models now available, Gemini 1.5 models deprecated

The list of available AI models has been recently updated with the following models:
  • AWS Claude 4 Sonnet
  • AWS Claude 4 Opus
The following models have been deprecated:
  • Google Gemini 1.5 Flash 001
  • Google Gemini 1.5 Pro 001
For more information, see retired models.Azure OpenAI GPT o4 Mini model was removed.Models offered in Preview mode have not been fully performance-tested at scale and are made available on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-05-15

Box CLI v4.1.0 released

New Features and Enhancements

Bug Fixes

  • Remove incorrect process.stderr.setEncoding call (486779e), closes #571
2025-05-13
Box Dotnet SDK Generated v1.10.0 released

New Features and Enhancements

  • Add UploadWithPreflightCheck convenient method (box/box-codegen#705) (#469) (8dff7bb)
  • Add AI agents warnings; allow for more types of metadata value (box/box-openapi#520) (#474) (a53cff5)
  • Add security settings properties on sign template schema (box/box-openapi#518) (#462) (7fddaea)
  • Add support of IBM models to AI API (box/box-openapi#522) (#475) (a187301)
  • Support sensitive data sanitization in errors (box/box-codegen#695) (#453) (5ee0c93)
2025-05-12

Box UI Elements v23.3.0 released

23.3.0 (2025-05-12)

Bug Fixes

Features

  • bp-assets: Bump BP assets to 4.39.0 (#4095) (15c403c)
  • content-sidebar: additional prop for feedback tooltip in Box AI (#4075) (bcd2b86)
  • content-sidebar: update content-answers for box ai sidebar (#4094) (8d4c456)
  • metadata-sidebar: Is delete confirmation modal checkbox enabled (#4076) (7e8c8ac)
  • metadataeditor: add agent selector (#4098) (f3af868)
  • metadataeditor: add ai extraction for folders (#4080) (82d6b29)
  • notification-redesign: Add Notification classname prop (#4092) (2dc371f)
  • opensource: update default route to use storybook (#4087) (174f335)
  • unified-share-modal: add custom permission descriptions (#4071) (19a7978)
  • upgrade blueprint packages (#4101) (f8606cf)

Reverts

2025-05-02

Box Python SDK Generated v1.14.0 released

Bug Fixes

New Features and Enhancements

  • Add security settings properties on sign template schema (box/box-openapi#518) (#543) (0a45d21)
  • Support sensitive data sanitization in errors (box/box-codegen#695) (#533) (abb7b1d)
2025-04-30

Box AI API - new AI models now available

The list of available AI models has been recently updated with the following models:
  • Azure OpenAI o3 (beta)
  • Azure OpenAI o4 mini (beta)
  • xAI Grok 3 (beta)
  • xAI Grok 3 mini (beta)
Models offered in Preview mode have not been fully performance-tested at scale and are made available on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-04-29

Box AI API - new AI models now available

The list of available AI models has been recently updated with the following models:
  • Azure OpenAI GPT-4.1
  • Azure OpenAI GPT-4.1 Mini
  • Gemini 2.5 Pro Preview
  • Gemini 2.5 Flash Preview
  • IBM Llama 4 Scout
  • IBM Llama 3.2 Instruct
Models offered in Preview mode have not been fully performance-tested at scale and are made available on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-04-29

Box Java SDK v4.16.1 released

Bug Fixes

  • use Locale.ROOT to prevent issues with non-US locales (#1306) (f083092)
2025-04-25

Box UI Elements v23.2.0 released

23.2.0 (2025-04-25)

Bug Fixes

Features

  • message-center: Pass badgeCount to ButtonComponent (#4068) (e316267)
  • unified-share-modal: add remove collaborators (#4070) (4645733)
2025-04-17

Box UI Elements v23.1.0 released

23.1.0 (2025-04-17)

Bug Fixes

Features

  • content-explorer: Add feature flag for MetadataViewList redesign (#4061) (5d0c716)
  • content-explorer: enable independent theming (#4062) (a67be72)
  • content-picker: Add MoreOptions button to rows (#4036) (f3667dc)
  • content-sidebar: added support for feedback tooltip in Box AI (#4059) (b09cbf3)
  • doc-first-pages: Add webp xrep header (#4054) (ca41b1a)
  • metadata-sidebar: Control Multilevel Taxonomy (#4037) (f705927)
  • metadata-sidebar: Multilevel taxonomy integration (#4044) (8a794ad)
2025-04-15

Box Java SDK v4.16.0 released

New Features and Enhancements

2025-04-11
Box TypeScript SDK Generated v1.15.1 released

Bug Fixes

2025-04-10

Box TypeScript SDK Generated v1.15.0 released

New Features and Enhancements

  • Support sensitive data sanitization in errors (box/box-codegen#695) (#573) (488e76a)
2025-04-09

Box Python SDK v3.14.0 released

New Features and Enhancements

  • Add stream_file_content parameter to upload methods (#890) (0e63c00)
2025-04-09

Box Node SDK v3.8.0 released

New Features and Enhancements

2025-03-26

Box UI Elements v23.0.0 released

23.0.0 (2025-03-26)

Features

  • BREAKING CHANGE noop to trigger major version release (#4034) (4e1751f)

BREAKING CHANGES

  • update peer dependencies for @box/ packages
2025-03-18

Box TypeScript SDK Generated v1.14.0 released

Bug Fixes

  • Add verification_phone_number property to create sign request (box/box-openapi#515) (#546) (916502c)

New Features and Enhancements

  • Add find app item for shared link endpoint (box/box-openapi#514) (#545) (7c32eaf)
  • Add Integration Mappings Teams API (box/box-openapi#517) (#548) (6ce1c7c)
  • Support upload with preflight check (box/box-codegen#676) (#554) (e3aa784)
2025-03-18
Box Swift SDK Generated 0.6.1 released

Bug Fixes

  • Add verification_phone_number property to create sign request (box/box-openapi#515) (#391) (717b3a8)

New Features and Enhancements

2025-03-18

Box Python SDK Generated v1.13.0 released

Bug Fixes

  • Add verification_phone_number property to create sign request (box/box-openapi#515) (#503) (6d19d19)

New Features and Enhancements

  • Add find app item for shared link endpoint (box/box-openapi#514) (#502) (fd6c693)
  • Add Integration Mappings Teams API (box/box-openapi#517) (#505) (d1aa250)
  • Support upload with preflight check (box/box-codegen#676) (#515) (bb4597e)
2025-03-18

Box Dotnet SDK Generated v1.9.0 released

Bug Fixes

  • Add verification_phone_number property to create sign request (box/box-openapi#515) (#427) (d90faea)
  • Use targetFramework when single .Net version is supported (box/box-codegen#684) (#438) (4e64174)

New Features and Enhancements

  • Add find app item for shared link endpoint (box/box-openapi#514) (#426) (4dc5dc1)
  • Add Integration Mappings Teams API (box/box-openapi#517) (#429) (92063c4)
  • Expose token storage for authentication classes (box/box-codegen#682) (#435) (413058e)
2025-03-12

Integration mappings for Teams

Use the integration mappings feature for MS Teams to manage where the content from Teams channels and chats is stored in Box.
  • List all Teams integration mappings
  • Create a new Teams integration mapping
  • Update existing Teams integration mapping
  • Delete Teams integration mapping
Check the integration mappings for Teams API developer guide to learn more about this feature.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-03-12

Box Java SDK v4.15.3 released

Bug Fixes

2025-03-11
Box TypeScript SDK Generated v1.13.2 released

Bug Fixes

  • Fix rollup plugin output directory in Typescript (box/box-codegen#678) (#543) (f828d5e)
2025-03-07
Box TypeScript SDK Generated v1.13.1 released

Bug Fixes

  • Split browser configuration in package.json for TypeScript (box/box-codegen#672) (#538) (ca7e291)
2025-03-07

Box CLI v4.0.1 released

Bug Fixes

  • Fix configure:environments:set-current command (#568) (dc0905f)
2025-02-26

Box Java SDK v4.15.2 released

Bug Fixes

  • Improve logging for API Request and API Response (#1295) (6eb1f57)
2025-02-26

Box AI API - AWS Claude 3.7 Sonnet now available

The list of available AI models has been recently updated with AWS Claude 3.7 Sonnet.Models offered in Preview mode have not been fully performance-tested at scale and are made available on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-02-24

Box Java SDK v4.15.1 released

Bug Fixes

2025-02-20

Box TypeScript SDK Generated v1.13.0 released

New Features and Enhancements

2025-02-20

Box Dotnet SDK Generated v1.8.0 released

Bug Fixes

  • Do not retry HTTP request when TaskCanceledException is thrown (box/box-codegen#665) (#406) (1af0a6a)

New Features and Enhancements

2025-02-19

Box Java SDK v4.15.0 released

New Features and Enhancements

  • Add canNonOwnersViewCollaborators flag to BoxFolder (#1288) (9119adc)
  • Support zstd encoding for downloads (#1287) (0e3c4c0)

Bug Fixes

2025-02-18

Box AI Studio API

We are excited to announce that Box AI Studio API is now available to all Enterprise Advanced customers. Box AI Studio allows you to build and manage custom AI agents to best suit your business needs. For example, you can create an AI agent that acts as a compliance consultant, answering questions regarding customer documentation with specific compliance rules in mind.Box AI Studio API allows you to:
  • List all AI agents
  • Get AI agent details
  • Create a new AI agent
  • Update existing AI agent
  • Delete an AI agent
Check the Box AI Studio API developer guide to learn more about this feature and check the API Reference for details.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-02-12

Box Python SDK Generated v1.11.1 released

Bug Fixes

2025-02-06

Box TypeScript SDK Generated v1.12.0 released

New Features and Enhancements

  • Add Box Sign shared requests (box/box-openapi#504) (#491) (e90255c)
  • feat: Add hubs support to /ai/ask. Replace type of items property from AiItemBase[] to AiItemAsk[] in the AiAsk interface (box/box-codegen#656) (#507) (9f29d8c)
  • Update /ai/extract_structured response schema (box/box-codegen#641) (#498) (502ac11)
2025-02-06

Box Python SDK Generated v1.11.0 released

Bug Fixes

  • Correct types of paged and thumb properties in File representation (box/box-openapi#503) (#451) (e818fa6)

New Features and Enhancements

  • Add Box Sign shared requests (box/box-openapi#504) (#453) (3590918)
  • feat: Add hubs support to /ai/ask. Replace type of items parameter from List[AiItemBase] to List[AiItemAsk] in create_ai_ask method (box/box-openapi#506) (#466) (29f0364)
  • Update /ai/extract_structured response schema (box/box-codegen#641) (#459) (7c73cea)
2025-02-06

Box Dotnet SDK Generated v1.7.0 released

Bug Fixes

  • Correct types of paged and thumb properties in File representation (box/box-openapi#503) (#383) (d6995ad)
  • Prevent Authentication header from being passed during cross-origin redirects (box/box-codegen#648) (#382) (a64d373)

New Features and Enhancements

  • Add Box Sign shared requests (box/box-openapi#504) (#384) (d563886)
  • feat: Add hubs support to /ai/ask. Replace type of Items property from IReadOnlyList<AiItemBase> to IReadOnlyList<AiItemAsk> in the AiAsk class (box/box-codegen#656) (#397) (32b6d03)
  • Update /ai/extract_structured response schema (box/box-codegen#641) (#391) (5f79a03)
2025-01-28

Box CLI v4.0.0 released

⚠ BREAKING CHANGES

  • Drop support old Node version and integrate typescript SDK (#548)

New Features and Enhancements

  • Drop support old Node version and integrate typescript SDK (#548) (22179ec)
  • Incognito browser option for box login (#561) (a666766)
  • Replace @oclif/command to @oclif/core library (#553) (aed470b)

Bug Fixes

  • Respect using environment defaultAsUserId for CCG Auth and OAuth (#554) (b3a691e)
2025-01-22

Box Java SDK v4.14.0 released

New Features and Enhancements

  • Support downloading file from shared link (#1282) (9b7f28b)

Bug Fixes

  • Remove sensitive data when BoxAPIException logs request (#1284) (f1e226f)
  • Support creating ongoing Legal Hold policy with start date (#1281) (d9564e2)
2024-01-13

Box Doc Gen

We are excited to announce that Box Doc Gen is now available to all Enterprise Advanced customers.Box Doc Gen allows you to generate various business documents based on Box Doc Gen templates uploaded to Box, with data fields that can be dynamically filled using Box Doc Gen API.Box Doc Gen functionality allows you to:Check the Box Doc Gen developer guides to learn more about Box Doc Gen and check the API Reference for Box Doc Gen API details.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2025-01-17

Google PaLM deprecation and removal

Google Pathways Language Models (PaLM) are being deprecated by Google.As a result, the following models will be removed from Box AI on 2025-01-17
  • text_bison
  • text_bison_32k
  • text_unicorn
  • google_text_embedding_gecko*
If you are using one of these models via agent override, check our list of supported models here.
2024-12-30
Box TypeScript SDK Generated v1.10.0 released

Bug Fixes

  • Remove unused parameter from SignRequest (box/box-openapi#489) (#450) (f5683b7)

New Features and Enhancements

  • Add support for replacing the network client implementation (box/box-codegen#629) (#454) (1cb7ddb)
  • Allow for customizing retry strategy (box/box-codegen#635) (#457) (530ca33)
  • Support webhook message validation (box/box-codegen#631) (#455) (09765a4)
2024-12-30

Box Python SDK Generated v1.9.0 released

Bug Fixes

  • Remove unused parameter from SignRequest (box/box-openapi#489) (#411) (578d9b4)

New Features and Enhancements

  • Add ai_agent info to AiResponse (box/box-openapi#485) (#402) (351a5b8)
  • Add support for replacing the network client implementation (box/box-codegen#629) (#415) (fb118dd)
  • Allow for customizing retry strategy (box/box-codegen#635) (#418) (8dfb3ed)
  • Support optional userId parameter for updating files, folders and web links (box/box-openapi#488) (#406) (d9cff4c)
  • Support webhook message validation (box/box-codegen#631) (#416) (0fec20b)
2024-12-10

Upcoming breaking change: Box AI API - Extract Structured

We would like to announce a planned breaking change in the Box AI API - Extract Structured endpoint. This change will bring improvements to the response by introducing additional fields and nesting the metadata key-value pairs within the answer object. This change is planned to be released mid-January. Be sure to follow our changelog and announcements on our Box Developer Blog. Expand to see code snippets examples:Current response example:
{
  "name": "Marie",
  "date": "10/2/23"
}
New response format example:
{
  "answer": {
    "name": "Marie",
    "date": "10/2/23"
  },
  "completion_reason": "done",
  "created_at": "2012-12-12T10:53:43-08:00"
}
2024-12-09

Box TypeScript SDK Generated v1.9.0 released

Bug Fixes

  • Fix signature of beforeRequest method in Interceptor interface (box/box-codegen#625) (#446) (ef2e765)

New Features and Enhancements

  • Add aiAgent info to AiResponse (box/box-codegen#624) (#440) (24c2013)
  • Support optional userId parameter for updating files, folders and web links (box/box-openapi#488) (#445) (874f259)
2024-12-05

CrowdStrike integration with Box

CrowdStrike is an endpoint detection tool integrated with Box to monitor endpoint activity. This means, CrowdStrike monitors devices that connect to Box and your Box organization, analyzing data about the connection and the device to identify potential threat activity.The integration with CrowdStrike comes with additional events in the event stream that can be triggered for an enterprise.For example, the EDR_CROWDSTRIKE_DEVICE_DETECTED event is triggered when a new device is detected by the the CrowdStrike Falcon platform. The full list includes the following events:
  • EDR_CROWDSTRIKE_DEVICE_DETECTED
  • EDR_CROWDSTRIKE_NO_BOX_TOOLS
  • EDR_CROWDSTRIKE_BOX_TOOLS_OUTDATED
  • EDR_CROWDSTRIKE_DRIVE_OUTDATED
  • EDR_CROWDSTRIKE_ACCESS_ALLOWED_NO_CROWDSTRIKE_DEVICE
  • EDR_CROWDSTRIKE_ACCESS_REVOKED

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-12-04

Box Dotnet SDK Generated v1.5.0 released

Bug Fixes

  • Support status codes with no content (box/box-codegen#604) (#314) (57747d5)
  • Update collaboration, metadata and collection resources (box/box-openapi#483) (#316) (d331f8a)

New Features and Enhancements

  • Add optional URL parameter to FetchResponse (box/box-codegen#617) (#331) (61484ec)
  • Allow using default credentials for proxy (box/box-codegen#623) (#334) (bc4636e), closes #333
  • Expose method for making custom HTTP requests (box/box-codegen#622) (#329) (e689140)
  • Support get collection by ID endpoint (box/box-codegen#595) (#304) (9ebf59a)
2024-12-03

Box TypeScript SDK Generated v1.8.0 released

Bug Fixes

  • Fix additionalProperties in ClientError (box/box-openapi#477) (#385) (4547148)
  • Fix chunked uploads in browser (box/box-codegen#619) (#436) (0af2484)
  • Support status codes with no content (box/box-codegen#604) (#415) (c3f14c6)
  • Update client error schema to support schema errors (box/box-openapi#467) (#381) (b845f12)
  • Update integration mapping response description (box/box-openapi#463) (#379) (e3d71e1)

New Features and Enhancements

  • Add AI LLM endpoint AWS params (box/box-openapi#478) (#388) (d2fd1ec)
  • Expose method for making custom HTTP requests, convert FetchOptions into a class (box/box-codegen#610) (#431) (9a9ea62)
  • Support get collection by ID endpoint (box/box-codegen#595) (#396) (f1f47be)
  • Support getting file download URL and file thumbnail URL (box/box-codegen#617) (#435) (1cb4d5d)
  • Support nullable fields in TypeScript (box/box-codegen#612) (#425) (991dc29)
2024-12-02

Box Python SDK Generated v1.8.0 released

Bug Fixes

New Features and Enhancements

  • Expose method for making custom HTTP requests (box/box-codegen#610) (#393) (55a23d9)
  • Support getting file download URL and file thumbnail URL (box/box-codegen#617) (#397) (fd609ab)
2024-11-29

Box Java SDK v4.13.1 released

Bug Fixes

  • Correctly calculate Content-Length when reading from a stream (#1277) (b1d5371)
2024-11-12

Apps & Integrations naming convention changes

We are changing the naming convention for apps & integrations to improve the clarity and consistency of our platform.

Developers

Current nameTarget nameLocation
App CenterPublishingA tab for submitting platform apps for publication in Box Integrations catalog
IntegrationsBox Web IntegrationsA tab where you define the third-party application buttons within the Box Web app
Custom appsPlatform appsDeveloper Console

Admins

Current nameTarget nameLocation
AppsIntegrationsAdmin Console
Custom Apps ManagerPlatform Apps ManagerAdmin Console
Custom appsPlatform AppsAdmin Console

Box Shield

Current nameTarget nameLocation
Application restriction policyIntegration restrictionRestriction policies
Shield ApplicationShield IntegrationShield integration lists
ApplicationsIntegrationsDetection Rules

Users

Current nameTarget nameLocation
AppsIntegrationsA tab in the Box web-app.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-11-04

Box Python SDK Generated v1.7.0 released

New Features and Enhancements

2024-10-31

Box Dotnet SDK Generated v1.4.0 released

Bug Fixes

  • Change QueryParams type in MetadataQuery from Dictionary<string, string> to Dictionary<string, object> (box/box-openapi#479) (#298) (656b495)
  • Fix conversion to RSAKey (box/box-codegen#591) (#297) (068b1f7)

New Features and Enhancements

  • add AI LLM endpoint AWS params. Change the type from AiLlmEndpointParamsGoogleOrAiLlmEndpointParamsOpenAi to AiLlmEndpointParamsAwsOrAiLlmEndpointParamsGoogleOrAiLlmEndpointParamsOpenAi (box/box-openapi#478) (#291) (dcb8a20)
2024-10-30

Box Python SDK Generated v1.6.0 released

Bug Fixes

  • Set stream position to 0 for multipart requests (box/box-codegen#581) (#348) (fa6942c)
  • Update client error schema (box/box-openapi#467) (#347) (a42a253)
  • Use original stream position when retrying requests (box/box-codegen#583) (#358) (060b4dc)
  • use raw docstrings when comments contain backslash (box/box-codegen#571) (#330) (8dd8cb7)

New Features and Enhancements

  • Add download_file_to_output_stream method to DownloadsManager (box/box-codegen#575) (#334) (6820d08)
  • add AI LLM endpoint AWS params (box/box-openapi#478) (#354) (c8fa2c1)
2024-10-24
Box Dotnet SDK Generated v1.3.1 released

Bug Fixes

  • properly serialize StringEnum list when inside query params (#288) (dac8392)
  • update client error schema to support schema errors (box/box-openapi#467) (#281) (bef2632)
  • update integration mapping response description (box/box-openapi#463) (#279) (05e07b0)
2024-10-24

Box AI API - AWS AI models now available

The list of available AI models has been recently updated with the following AWS models:
  • AWS Claude 3 Sonnet
  • AWS Claude 3.5 Sonnet
  • AWS Claude 3 Haiku
  • AWS Titan Text Lite
Models offered in Preview mode have not been fully performance-tested at scale and are made available on an as-is basis. You may experience variability in model/output quality, availability, and accuracy.You can use the provided models to override the default model used in the AI agent configuration. For further details on Box AI API, see the guides and API reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-10-22

Box AI API — Document Q&A and Box AI API — Text Generation generally available

We are excited to announce that Box AI API — Document Q&A and Box AI API — Text Generation features are now available to all Enterprise Plus customers.Box AI API allows you to use Box AI functionality in your custom applications. For example, you can implement Box AI question and answer functionality in your third party applications,or generate content right in your product’s content editor. You can also extract metadata from the provided documents.Endpoints related to metadata extraction are currently a beta feature offered subject to Box’s Main Beta Agreement, and the available capabilities may change.Currently, Box AI functionality allows you to:
  • Get responses to your questions.
  • Get a summary of a document.
  • Generate text you can use in your documents.
  • Extract metadata from the provided file in a flexible way, meaning you have more freedom when using the prompt.
  • Extract metadata from the provided file using a metadata template or the fields structure.
  • Fetch and override the default API model configuration.
Check the Box AI API developer guides to learn more about Box AI and check the API Reference for Box AI API details.

Box AI for UI Elements

Box AI for UI Elements enhances Content Preview with Box AI - Document Q&A and Text Generation functionality. The enhanced Box AI for UI Elements allows the users to embed AI functionality in their custom applications to facilitate answering questions, summarizing a document, adding citations and using dialogue history, and formatting support.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-10-21

Box UI Elements v22.0.0 released

22.0.0 (2024-10-21)

Bug Fixes

Features

  • taxonomy: added view/create/updated taxonomy field support (#3716) (cccb0b0)
  • noop for BREAKING CHANGE blueprint peer dependency (#3721) (5a117ae)
  • api: add handling empty metadata suggestions (#3608) (ecd4c80)
  • api: Extend getMetadata in Metadata API (#3611) (765f592)
  • blueprint: Added blueprint (#3585) (0f2d876)
  • boxai-sidebar: BoxAISidebar header added (#3698) (130b6b6)
  • boxai-sidebar: Empty Sidebar for Box AI (#3668) (611377c)
  • content-answers: Upgrade Content Answers (#3658) (002d496), closes #3626
  • content-explorer-modal-container: add optional info notice (#3634) (20d4c3f)
  • content-sidebar: add archived date to content preview sidebar (#3625) (10e68f3)
  • content-sidebar: Add data-target-id to menu items (#3610) (cf05167)
  • content-sidebar: Add placeholder metadatasidebar redesigned (#3570) (6a0d7ee)
  • content-sidebar: disable version modifications for archive file (#3637) (e735c4c)
  • content-sidebar: pass metadata.aiSuggestions flag into redesigned sidebar (#3665) (b672f70)
  • metadata-sidebar: Add handler for Autofill button (#3700) (95735e0)
  • metadata-sidebar: Add metadata instance list (#3664) (b4e4b01), closes #3605
  • metadata-sidebar: disable delete button (#3677) (2941a97)
  • metadata-sidebar: Handle create metadata instance (#3663) (321ba7e)
  • metadata-sidebar: handle delete metadata instance (#3662) (f6abd4e)
  • metadata-sidebar: handle update metadata instance (#3672) (ef79e44)
  • metadata-sidebar: Metadata sidebar redesign (#3654) (fe4fede), closes #3606
  • metadata-sidebar: pass areAiSuggestionsAvailable based on file ext (#3675) (dc074cf)
  • metadata-sidebar: tab content styles change (#3708) (f7c06a4)
  • taxonomy: added metadata options endpoint (#3678) (47ba331)
  • taxonomy: added metadata taxonomy field support (#3710) (3a0c27e)
  • uaa-logging: Log UAA Parity data (#3629) (6cb5d8f)
  • unified-share-modal: add custom avatars click handler (#3688) (c034de4)
  • update_app_activity_item: Add permissions field (#3680) (c521c11)
  • support /2.0/ai/extract_structured endpoint (#3596) (dee4eee)
  • unified-share-modal: added targeting attribute (#3592) (e26f1f1)
  • support metadata suggestions API (#3571) (c985402), closes #3565

Performance Improvements

  • content-answers: lazy load content answers in preview (#3720) (ec115f7)

Reverts

BREAKING CHANGES

  • blueprint-web and blueprint-web-assets peer dependencies
2024-10-18

Box Java SDK v4.12.0 released

New Features and Enhancements

2024-10-17

Box TypeScript SDK Generated v1.7.0 released

New Features and Enhancements

  • Include raw data in response object (box/box-codegen#576) (#375) (bdb9d0c)
  • Support ai/extract and ai/extract_structured endpoints (box/box-codegen#566) (#356) (4a33562)
2024-10-17

Box Dotnet SDK Generated v1.3.0 released

Bug Fixes

New Features and Enhancements

2024-09-26

Box Dotnet SDK Generated v1.2.0 released

Bug Fixes

  • correctly send datetime when in queryParams (box/box-codegen#560) (#243) (9657526)
  • Fix variants in metadata query results (box/box-openapi#456) (#249) (37625ea)

New Features and Enhancements

2024-09-19

Box AI API default model update

Box AI Platform API has been updated with a new default model for the POST /2.0/ai/ask endpoint. Both single and multiple document modes are now based on Azure’s gpt-4o-mini.
Note: Box AI Platform API is currently a beta feature offered subject to Box’s Main Beta Agreement, and the available capabilities may change. Box AI Platform API is available to all Enterprise Plus customers.
For more information on default agent configuration and supported AI models visit developer guides.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-09-19

Box Python SDK Generated v1.5.1 released

Bug Fixes

  • Fix proxy url without proxy credentials (box/box-codegen#568) (#322) (fb19160), closes #318
  • Stop sending last empty chunk for chunk upload (box/box-codegen#569) (#324) (1605f04), closes #321
2024-09-18

Box Python SDK Generated v1.5.0 released

Bug Fixes

  • Add the missing license to setup.py (box/box-codegen#562) (#307) (679d789)
  • Fix variants in metadata query results (box/box-openapi#456) (#313) (8830303)

New Features and Enhancements

  • Add support for proxy (box/box-codegen#559) (#302) (3d881ac)
  • Introduce raw_data field for storing raw json response (box/box-codegen#566) (#319) (3776dc3)
  • Support ai/extract and ai/extract_structured endpoints (box/box-codegen#564) (#317) (b3d8da4)
  • Support App item associations (box/box-codegen#561) (#299) (8b6ea0b)
2024-09-17

Metadata extraction with Box AI Platform API now available in Beta

With its recent addition, Box AI Platform API allows you to extract metadata from the provided input. For example you can extract the financial information from an invoice, or patient data from a medical certificate.
Note: Box AI Platform API is currently a beta feature offered subject to Box’s Main Beta Agreement, and the available capabilities may change. Box AI Platform API is available to all Enterprise Plus customers.
You have the following options:POST /2.0/ai_extract endpoint allows you to extract metadata from the provided file in a freeform way. This means you have more freedom in creating the prompt, and the metadata template is not required to run the request. POST /2.0/ai_extract_structured endpoint allows you to extract metadata from the provided file using a metadata template or fields structure.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-09-16

App item associations

The app item associations API allows you to check which app items are connected with a specific file or folder, including the app items associated with ancestors of the file or folder.An app item is a content object owned by an application. It can group files and folders together from different paths. That set can be shared through a collaboration.An app item association is a connection between a file or folder and an app item. Associations between a folder and an app item cascade down to all descendants of the folder.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-09-11

Box TypeScript SDK Generated v1.6.0 released

Bug Fixes

  • Add the missing license to package.json (box/box-codegen#562) (#343) (cc9a8b8)
  • Fix variants in metadata query results (box/box-openapi#456) (#349) (2131e98)

New Features and Enhancements

2024-09-11

Box Swift SDK Generated 0.5.0 released

Bug Fixes

  • Fix variants in metadata query results (box/box-openapi#456) (#232) (be2fa52)

New Features and Enhancements

2024-09-05

Box Swift SDK Generated 0.4.0 released

Bug Fixes

  • Add missing fields to Sign Template Signer and fix AI schema (box/box-openapi#451) (#206) (31920e6)
  • Fix IntegrationMapping schemas (box/box-codegen#551) (#203) (0074ee3)
  • Fix chunk upload in Swift (box/box-codegen#555) (#215) (93ff568)

New Features and Enhancements

2024-08-30
Box TypeScript SDK Generated v1.5.1 released

Bug Fixes

  • Fix fetch options with interceptor (box/box-codegen#556) (#326) (3751eea)
2024-08-30

Box Python SDK Generated v1.4.1 released

Bug Fixes

  • Do not store data in-memory during download process in Python (box/box-codegen#557) (#294) (7c645ae)
2024-08-23

Box TypeScript SDK Generated v1.5.0 released

Bug Fixes

  • Add missing fields to Sign Template Signer and fix AI schema (box/box-openapi#451) (#317) (340fbd8)
  • Fix IntegrationMapping schemas (box/box-codegen#551) (#315) (a863b1e)

New Features and Enhancements

  • Add new parameters to Box AI methods and introduce AiResponseFull variant (box/box-openapi#446) (#313) (d9664fd)
  • Include URL into FetchOptions (box/box-codegen#549) (#319) (30eaa6b)
2024-08-23

Box Python SDK Generated v1.4.0 released

Bug Fixes

  • Add missing fields to Sign Template Signer and fix AI schema (box/box-openapi#451) (#281) (0708351)
  • Fix IntegrationMapping schemas (box/box-codegen#551) (#279) (0337e06)

New Features and Enhancements

  • Add new parameters to Box AI methods and introduce AiResponseFull variant (box/box-openapi#446) (#277) (1267a21)
  • Include URL into FetchOptions (box/box-codegen#549) (#283) (dd05b1c)
2024-08-23

Box Dotnet SDK Generated v1.1.0 released

Bug Fixes

  • Add missing item_upload scope (#201) (483b055)
  • Add missing fields to Sign Template Signer and fix AI schema (box/box-openapi#451) (#229) (121f733)
  • Fix IntegrationMapping schemas (box/box-codegen#551) (#226) (3eca154)
  • Improve handling of network exceptions, handle big file upload (box/box-openapi#444) (#222) (75ccd07)

New Features and Enhancements

  • Add new parameters to Box AI methods and introduce AiResponseFull variant (box/box-openapi#446) (#224) (6d205c4)
  • Include URL into FetchOptions (box/box-codegen#549) (#231) (41c45dc)
  • Parametrize chunked uploads endpoint URLs (box/box-openapi#444) (#208) (feac37c)
  • Support nullable fields (box/box-codegen#550) (#230) (b9da32b)
2024-08-22
Box Swift SDK Generated 0.3.1 released

Bug Fixes

  • Extract IntegrationMappingPartnerItemSlack to IntegrationMappingPartnerItemSlackUnion (box/box-codegen#530) (#165) (d51df9a)
  • Improve chunked upload reliability (box/box-codegen#529) (#164) (5d87629)
  • Retry requests with 202 status code and Retry-After header (box/box-codegen#538) (#177) (64f27b3)

New Features and Enhancements

  • Add is_active parameter to user collaboration (box/box-openapi#437) (#163) (5f726bb)
  • Add new parameters to Box AI methods and introduce AiResponseFull variant (box/box-openapi#446) (#201) (7c09090)
  • Add support for Swift 5.6 (box/box-codegen#541) (#180) (04b7020)
  • parametrize chunked uploads endpoint URLs (box/box-openapi#444) (#192) (ea18f9e)
  • Support AI Agent API (box/box-codegen#531) (#170) (fc9a00b)
2024-08-22

Box Python SDK v3.13.0 released

New Features and Enhancements

  • Add support for get AI agent default (#883) (c1010e0)
2024-08-12

Box TypeScript SDK Generated v1.4.0 released

Bug Fixes

New Features and Enhancements

  • Parametrize chunked uploads endpoint URLs (box/box-openapi#444) (#302) (293a6e9)
  • ts: Add comments to properties and methods (box/box-codegen#537) (#284) (db3a2b5)
2024-08-12

Box Python SDK Generated v1.3.0 released

Bug Fixes

  • Fix fetch method for multipart request (box/box-codegen#545) (#266) (08a0818)

New Features and Enhancements

  • Parametrize chunked uploads endpoint URLs (box/box-openapi#444) (#264) (b5bce24)
2024-08-06

Box Python SDK v3.12.0 released

New Features and Enhancements

  • add create sign request function with different required parameters (#878) (d972f54)
  • Support Box AI features (#877) (3026d2a)
2024-08-06

Box Node SDK v3.7.1 released

Bug Fixes

  • add version to copy file options annotation (#885) (4f9312c)
2024-08-06

Box CLI v3.15.0 released

New Features and Enhancements

2024-07-26

Box Python SDK Generated v1.2.0 released

Bug Fixes

New Features and Enhancements

2024-07-25

Introducing New Generation Swift SDK

We are excited to introduce Box Swift SDK, designed to elevate the developer experience and streamline your integration with the Box Content Cloud.With the new generation of Swift SDK, you’ll have access to:
  • Full API Support: The new generation of Box SDKs empowers developers with complete coverage of the Box API ecosystem. You can now access all the latest features and functionalities offered by Box, allowing you to build even more sophisticated and feature-rich applications.
  • Rapid API Updates: Say goodbye to waiting for new Box APIs to be incorporated into the SDK. With our new auto-generation development approach, we can now add new Box APIs to the SDK at a much faster pace (in a matter of days). This means you can leverage the most up-to-date features in your applications without delay.
  • Embedded Documentation: We understand that access to information is crucial for developers. With our new approach, we have included comprehensive documentation for all objects and parameters directly in the source code of the SDK. This means you no longer need to look up this information on the developer portal, saving you time and streamlining your development process.
  • Enhanced Convenience Methods: Our commitment to enhancing your development experience continues with the introduction of convenience methods. These methods cover various aspects such as authentication, chunk uploads, exponential back-offs, automatic retries, type checkers which help to ensure that you’re using variables correctly, and much more.
Embrace the new generation of Box SDKs and unlock the full potential of the Box Content Cloud. Start building innovative solutions faster and more efficiently. Happy coding!
2024-07-25

Fetch and override default AI configuration

Thanks to the GET /2.0/ai_agent_default endpoint you can now fetch the default configuration for AI services.Once you get the configuration details, you can override them using the ai_agent parameter available in the POST /2.0/ai/ask and POST /2.0/ai/text_gen requests.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-07-24

Box TypeScript SDK Generated v1.3.0 released

Bug Fixes

  • Extract IntegrationMappingPartnerItemSlack to union type (box/box-codegen#530) (#255) (fa8952a)
  • Improve chunked upload reliability (box/box-codegen#529) (#254) (12d9288)

New Features and Enhancements

2024-07-24

Box Dotnet SDK Generated v1.0.0 released

Bug Fixes

  • Extract IntegrationMappingPartnerItemSlack to IntegrationMappingPartnerItemSlackUnion (box/box-codegen#530) (#183) (3b1b634)
  • Improve chunked upload reliability (box/box-codegen#529) (#182) (e2a045f)
  • remove init from some of the required fields, nullability fixes (box/box-codegen#532) (#190) (c58f8af)
  • retry requests with status code of 202 and retry-after header (box/box-codegen#533) (#191) (abaafd7)
  • Update chunked upload (box/box-codegen#523) (#177) (9bcaf51)

New Features and Enhancements

  • Add is_active parameter to user collaboration (box/box-openapi#437) (#181) (ec5f2d1)
  • simplify namespaces (box/box-codegen#518) (#175) (7831b09)
  • Support AI Agent API (box/box-codegen#531) (#188) (0c29645)
  • Support default interface properties, bump dependencies (box/box-codegen#527) (#184) (6b52792)
2024-07-22

Box Windows SDK v5.8.0 released

New Features and Enhancements:Bug Fixes:
  • Bump System.IdentityModel.Tokens.Jwt dependency version to v6.35.0 (#962) (6e47237), closes #960 #961
  • remove Microsoft.AspNetCore.StaticFiles and System.Web dependencies (#964) (2c8eedc)
2024-07-17

React 18 support for Box UI Elements

Box UI Elements now support React 18, bringing a whole new level of flexibility and functionality for content collaboration in third-party apps. With this update, you can leverage the power of React 18’s cutting-edge features, drive innovation with latest front-end stack, while seamlessly integrating with the intelligent content cloud.For details, read our blog post.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-07-16

Box UI Elements v21.0.0 released

21.0.0 (2024-07-16)

Bug Fixes

Features

  • docgen: add docgen icon (#3573) (f5d4955)
  • react: BREAKING CHANGE Upgrade to React 18 (#3556) (91e0978)
  • webpack: BREAKING CHANGE Upgrade to webpack 5 and react-styleguidist 12.0.1 (#3568) (a812294)

BREAKING CHANGES

  • upgrade hapi/address to resolve undefined buffer reference
  • upgrade peer dependency for react-virtualized to support react 18
2024-07-16

Box Node SDK v3.7.0 released

New Features and Enhancements

2024-07-16

Box Java SDK v4.11.1 released

Bug Fixes

  • Fix order of file upload multipart request (#1261) (7200ac7)
2024-07-15

Box Java SDK v4.11.0 released

New Features and Enhancements

  • Allow overriding creation of OkHttp Call (#1257) (bd6fde6)

Bug Fixes

  • Add missing fields when update classification template (#1255) (f17f817)
  • Fix deserializing permissions for BoxFile and BoxFolder (#1256) (f088448)
2024-07-08

Box TypeScript SDK Generated v1.2.0 released

Bug Fixes

New Features and Enhancements

  • Retry request with status code 202 (box/box-codegen#511) (#235) (03b8f43)
  • Support extensible enum types in Typescript (box/box-codegen#520) (#243) (5237972)
2024-07-03

Box Dotnet SDK Generated v0.4.0 released

Bug Fixes

  • Change base URLs (box/box-codegen#491) (#126) (b4c6025)
  • Fix CI for auto update pull requests (box/box-codegen#506) (#152) (766f03c)
  • Fix schema for updating classification on a file and folder (box/box-openapi#423) (#117) (40f5a97)
  • Improve wording for box sign (box/box-openapi#424) (#122) (64b3bcd)

New Features and Enhancements

  • Add default implementation for interface methods (box/box-codegen#502) (#148) (0f39071)
  • Add docs improvements and marker pagination (box/box-openapi#431) (#153) (780a58b)
  • Add support for ExtraData of generic type (box/box-codegen#521) (#170) (2a2208d)
  • Add support for unions of primitives (box/box-codegen#501) (#150) (e75ce82)
  • Make models immutable, hide fields for authentication (box/box-codegen#494) (#127) (8adcc85)
  • Add SuppressNotifications and ExternalSystemName fields for Box Sign (box/box-openapi#425) (#124) (c841881)
  • Support StringEnum (box/box-codegen#514) (#162) (6ac2fe9)
2024-06-28

Box Windows SDK v5.7.1 released

Bug Fixes:
2024-06-28

Box Swift SDK Generated 0.3.0 released

Bug Fixes

  • Change base URLs (box/box-codegen#491) (#115) (d0a7adb)
  • Fix Box AI endpoints (box/box-openapi#418) (#88) (022f83a)
  • Fix CI for auto update pull requests (box/box-codegen#506) (#135) (a62e238)
  • fix deserialisation of Union with array in Swift (box/box-codegen#486) (#94) (4f187be)
  • Fix metadata filter resource (box/box-openapi#419) (#90) (b04f7ce)
  • Fix schemas for updating classification on a file and folder (box/box-openapi#423) (#104) (caa9d2b)
  • improve wording for box sign (box/box-openapi#424) (#111) (4fa69f0)

New Features and Enhancements

  • add missing marker pagination fields and introduce new event type (box/box-openapi[#431](https://github.com/box/box-codegen/issues/431)) (#136) (b186b11)
  • Add support for visionOS and add privacy manifest file for swift (box/box-codegen[#510](https://github.com/box/box-codegen/issues/510)) (#139) (7fc76fc)
  • Add support for Date in Swift (box/box-codegen#488) (#103) (7e1ea1a)
  • Improve chunk upload in Swift (box/box-codegen[#515](https://github.com/box/box-codegen/issues/515)) (#143) (b8099ab)
  • move notification suppression to public schema (box/box-openapi#425) (#113) (069be60)
  • Move schemas to separate modules (box/box-codegen#483) (#99) (c7a8506)
  • Start throwing common errors (box/box-codegen[#516](https://github.com/box/box-codegen/issues/516)) (#147) (d12bbb7)
  • Support Box AI endpoints (box/box-openapi#416) (#86) (175ab82)
  • Support chunk upload in Swift (box/box-codegen[#513](https://github.com/box/box-codegen/issues/513)) (#142) (9e0b4e2)
  • support excluding endpoints and schemas in parser (box/box-codegen#487) (#100) (af9e171)
2024-06-12

Box TypeScript SDK Generated v1.1.0 released

Bug Fixes

  • Fix CI for auto update pull requests (box/box-codegen#506) (#221) (bbc14f6)
  • remove quotation mark when date or datetime is used in queryParams (box/box-codegen#509) (#225) (28d2220)

New Features and Enhancements

  • add missing marker pagination fields and introduce new event type AppItemEventSource (box/box-openapi[#431](https://github.com/box/box-typescript-sdk-gen/issues/431)) (#224) (6c18ca3)
2024-06-12

Box Python SDK Generated v1.1.0 released

Bug Fixes

  • Fix CI for auto update pull requests (box/box-codegen#506) (#187) (5e59f69)

New Features and Enhancements

  • add missing marker pagination fields and introduce new event type AppItemEventSource (box/box-openapi[#431](https://github.com/box/box-codegen/issues/431)) (#189) (8d22ce2)
2024-06-07

Box Python SDK v3.11.0 released

New Features and Enhancements

  • Use upload session urls for chunk upload (#875) (c67b03c)
2024-06-06

Box Java SDK v4.9.1 released

Bug Fixes

  • Bumped org.bouncycastle:bcprov-jdk18on:1.78.1 and org.bouncycastle:bcpkix-jdk18on:1.78.1 (#1246) (0557bed)
2024-06-06

Box Java SDK v4.10.0 released

New Features and Enhancements

  • Overload the getRepresentationContent method with a maxRetries parameter (#1251) (d26bd4f)
  • Support login_required, password, suppress_nofitications, verification_phone_number and additional_info fields in sign request (#1250) (3ee55b3)
2024-06-06

Box CLI v3.14.1 released

Bug Fixes

  • Fix bulk action in search command (#528) (782b0e6)
  • Fix bulk operation for sign-requests:create command (#531) (6d9cd6b)
2024-05-31

Box UI Elements v20.0.1-beta.1 released

20.0.1-beta.1 (2024-05-31)

Bug Fixes

2024-06-18

PDF.js vulnerability affecting Box Preview SDK

A CVE-2024-4367 vulnerability has been identified in the PDF.js library used by Box Preview SDK. The vulnerability exposes a gap in the PDF.js type, checking code that allows for arbitrary JavaScript to run when opened in Preview.Since this vulnerability existed in all versions of PDF.js that were lower or equal to 4.1.392, it affects all versions of Preview SDK lower than 2.106.0. To mitigate this vulnerability, upgrade the Preview SDK used in your apps to 2.106.0 or higher.All customers and application owners who are potentially affected have been notified directly via email.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-05-22

Box UI Elements v20.0.0 released

20.0.0 (2024-05-22)

Bug Fixes

Features

  • content-explorer: allow not using Portal when rendering modal (#3501) (b096d38)
  • content-uploader: Added allowPrepopulateFiles prop to content uploader (#3519) (12427b1)
  • content-uploader: Implemented partial upload for successful file transfers (#3529) (e70825c)
  • docgen: docgen sidebar base (#3484) (4b18b21)
  • react-intl: Bump react-intl package [BREAKING CHANGE] (#3466) (307c6a4)
  • usm: Add access level label for hubs (#3526) (6504480)
  • usm: add inline notice as component (#3549) (d646c65)

BREAKING CHANGES

  • react-intl: upgrade the major version of the react-intl dependency
  • fix: fix intl type
  • fix: fix message syntax
  • fix: fix comments and i18n readme file
  • fix: fix react-intl version comments
  • fix: use IntlShape as a type in js files
  • Fix: correct type import for IntlShape
  • fix: add resolution
  • fix: use exact version to match other repositories
  • Fix: correct type import for IntlShape
  • fix: remove all support for legacy versions
  • fix: add relativeTime helper function
  • fix: fix relativeTime in PresenceAvatarTooltipContent component
  • fix: fix relativeTime in PresenceCollaborator component
  • fix: use inclusive inequalities in relativeTime helper
  • fix: remove unnecessary modulo operations
  • fix: fix relativeTime in ReadableTime + fix snapshots
  • fix: fix relativeTime in lastModifiedByCellRenderer
  • fix: fix tests
  • fix: use js
  • fix: fix import
  • fix: fix else statement
  • fix: revert import reorder
2024-05-22

Box Python SDK v3.10.0 released

New Features and Enhancements

Bug Fixes

  • Change exception type for missing location header (#871) (8c5e0ec)
  • fix annotation of oauths access_token (#855) (804780e)
  • Fix retention policy integration test (#867) (8e0d640)
  • Remove delete classification (#861) (393cfef)
  • Update exception file get download URL (#866) (94dcbcd)
2024-05-20

Introducing New Generation Python SDK

We are excited to introduce Box Python SDK, designed to elevate the developer experience and streamline your integration with the Box Content Cloud.With the new generation of Python SDK, you’ll have access to:
  • Full API Support: The new generation of Box SDKs empowers developers with complete coverage of the Box API ecosystem. You can now access all the latest features and functionalities offered by Box, allowing you to build even more sophisticated and feature-rich applications.
  • Rapid API Updates Say goodbye to waiting for new Box APIs to be incorporated into the SDK. With our new auto-generation development approach, we can now add new Box APIs to the SDK at a much faster pace (in a matter of days). This means you can leverage the most up-to-date features in your applications without delay.
  • Embedded Documentation: We understand that access to information is crucial for developers. With our new approach, we have included comprehensive documentation for all objects and parameters directly in the source code of the SDK. This means you no longer need to look up this information on the developer portal, saving you time and streamlining your development process.
  • Enhanced Convenience Methods: Our commitment to enhancing your development experience continues with the introduction of convenience methods. These methods cover various aspects such as authentication, chunk uploads, exponential back-offs, automatic retries, type checkers which help to ensure that you’re using variables correctly, and much more.
Embrace the new generation of Box SDKs and unlock the full potential of the Box Content Cloud. Start building innovative solutions faster and more efficiently. Happy coding!
2024-05-20

Box Node SDK v3.6.0 released

New Features and Enhancements

2024-05-20

Introducing New Generation TypeScript SDK

We are excited to introduce Box TypeScript SDK, designed to elevate the developer experience and streamline your integration with the Box Content Cloud.With the new generation of Typescript SDK, you’ll have access to:
  • Full API Support: The new generation of Box SDKs empowers developers with complete coverage of the Box API ecosystem. You can now access all the latest features and functionalities offered by Box, allowing you to build even more sophisticated and feature-rich applications.
  • Rapid API Updates: Say goodbye to waiting for new Box APIs to be incorporated into the SDK. With our new auto-generation development approach, we can now add new Box APIs to the SDK at a much faster pace (in a matter of days). This means you can leverage the most up-to-date features in your applications without delay.
  • Embedded Documentation: We understand that access to information is crucial for developers. With our new approach, we have included comprehensive documentation for all objects and parameters directly in the source code of the SDK. This means you no longer need to look up this information on the developer portal, saving you time and streamlining your development process.
  • Enhanced Convenience Methods: Our commitment to enhancing your development experience continues with the introduction of convenience methods. These methods cover various aspects such as authentication, chunk uploads, exponential back-offs, automatic retries, type checkers which help to ensure that you’re using variables correctly, and much more.
Embrace the new generation of Box SDKs and unlock the full potential of the Box Content Cloud. Start building innovative solutions faster and more efficiently. Happy coding!
2024-05-15

Notification suppression for Box Sign

Box Sign API allows you to suppress the default Box email notifications sent during the Box Sign workflow.​​Thanks to this feature, you can turn the default notifications off to use your own, customized messages and decide on channels they will be sent through.Note: When you choose to suppress email notifications for Box Sign, your organization assumes responsibility for ensuring the delivery to Signers of all notifications at the appropriate time in the signing process and with the appropriate content, in compliance with all applicable laws and regulations, including with respect to obtaining Signer consent to the delivery methods used, if applicable.

New Box Sign webhooks

Along with the notification suppression feature, we introduce three new webhooks to enhance the customization options for e-signature workflows:
  • SIGN.REQUEST.SIGNATURE_REQUESTED
  • SIGN.REQUEST.SIGNER_SIGNED
  • SIGN.REQUEST.ERROR_FINALIZING
You can use these webhooks to trigger actions in your own applications or notify your users about events happening in Box Sign.​​

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-05-07

Box Java SDK v4.9.0 released

New Features and Enhancements

Bug Fixes

  • Support create empty shared link (#1241) (0c86487)
  • Update exception message for get representation content (#1239) (a608f9a)
2024-05-03

Introducing Box AI API and Box AI Dev Zone

Box AI API allows you to use Box AI functionality in your custom applications. For example, you can implement Box AI question and answer functionality in your third party applications or generate content right in your product’s content editor.Box AI API and Box AI for UI Elements are beta features, which means the available capabilities may change. Box AI features are available to all Enterprise Plus customers.Currently, you can ask Box AI to answer your questions, summarize the document content, or generate text you can use in your documents. Check the Box AI API developer guides to learn more about Box AI and check the API Reference for details.

Box AI Developer Zone

Alongside with the Box AI API, we have launched a new developer documentation demo page. Box AI Dev Zone allows you to explore the Box AI API through rich, interactive experiences. You can view use cases, example prompts and responses, and sample code.

Box AI for UI Elements

Box AI for UI Elements enhances the Content Preview header with AI Q&A functionality. The new Box AI for UI Elements allows the users to embed AI functionality in their custom applications to facilitate answering questions and taking actions like summarizing a document.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-05-02

Box Node SDK v3.5.1 released

Bug Fixes

  • Fix options parameter in metadata query method (#878) (7943420)
2024-04-05

Box iOS SDK v5.6.0 released

New Features and Enhancements

2024-03-06

Box CLI v3.14.0 released

New Features and Enhancements

  • Add support for vanity_name when creating shared-links (#524) (38164bc)
  • Support sign request signer group ID (#521) (f7b1b44)
2024-02-27

Box Windows SDK v5.7.0 released

New Features and Enhancements:
  • add marker-based pagination version of GetFolderItems (#936) (f877a8f)
  • Support sign request signer group ID (#938) (096a098)
Bug Fixes:
2024-02-27

Box Java SDK v4.8.0 released

New Features and Enhancements

  • allow modifying BoxAPIRequest URL (#1236) (eaea019)
  • Bumped org.bouncycastle:bcprov-jdk18on:1.77 and org.bouncycastle:bcpkix-jdk18on:1.77 (#1237) (6c7fe7b), closes #1235

Bug Fixes

  • fix download for empty files (#1231) (0e2230b)
  • stop using SharedLinkAPIConnection in getSharedItem() (#1234) (9f9af8e)
2024-02-22

Box CLI v3.13.0 released

New Features and Enhancements

  • Add additional UseDisplayName flag to metadata extraction script (#515) (b900fdb)
  • Add additional context info when throw exception (#519) (b99a58d)
  • Support overwrite/skip folder download (#516) (300f914)

Bug Fixes

  • Fix metadata extraction script (#514) (2fad540)
  • Fix the functionality of the overwrite flag (#513) (f4bf7af)
2024-02-19

Box Node SDK v3.5.0 released

New Features and Enhancements

Bug Fixes

2024-02-06

Working with Box Sign

We are thrilled to announce the release of our new dedicated resource page Working with the Box Sign API. This comprehensive guide is designed to help you seamlessly integrate Box Sign into your applications, providing you with the tools and knowledge to make the most out of this powerful e-signature solution.

Table of content

2024-02-02

Metadata view in Content Explorer

Content Explorer comes with a metadata view that uses metadata query to find files and folders. The data is then displayed in the embedded view.For details, read the Content Explorer guide and our blog post.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-01-25

Box UI Elements v19.0.0 released

19.0.0 (2024-01-25)

Bug Fixes

Features

  • aci: add ACI config to features prop (#3410) (e95a35e)
  • activityitems: new layout (#3405) (665d30a)
  • annotations: editing an annotation reply (#3412) (025ad7e)
  • assets: add Box AI assets (#3393) (bc6b04d)
  • content-answers: add contentAnswers Modal header and footer (#3403) (a7d0a3e)
  • content-answers: add inline error (#3444) (405cdb4)
  • content-answers: add modal body with initial welcome message (#3415) (6748e73)
  • content-answers: add prop to control displaying contentAnswers (#3399) (f0b0922)
  • content-answers: add scrolling to bottom (#3442) (59c8c45)
  • content-answers: Avatar (#3418) (45166f4)
  • content-answers: button focusing (#3448) (2358321)
  • content-answers: Content Answers Modal Error (#3425) (a5084a5)
  • content-answers: create initial content-answers modal button component (#3395) (217a393)
  • content-answers: Deactivate button when not allowed file type (#3406) (f950772)
  • content-answers: intelligence API (#3420) (76fd991)
  • content-answers: Questions Answers Intelligence endpoint (#3435) (4c7c0c0)
  • content-answers: retry button (#3451) (e0976b8)
  • content-explorer: Add auto selected items to content explorer (#3474) (215cfdd)
  • content-sidebar: enable responsiveness for Preview and Sidebar (#3497) (1652982)
  • label-primitive: pass properties to label (#3473) (7e88772)
  • modal: enable responsive behavior (#3492) (7fe59b8)
  • pill-selector: added more options for text input (#3440) (d782e4a)
  • preview: Focus on comment form for replies and modifying (#3407) (69293d8)
  • threaded-replies: added resolve/unresolve for annotations (#3423) (c489ad3)
  • threaded-replies: delete threaded reply comments (#3402) (37437c5)
  • uaa-integration: Handle no comment permission (#3394) (5a28b49)
  • uaa-integration: Parse App Activity item (#3386) (44fd12b)
  • uaa-integration: Parse Versions Response from UAA (#3385) (0fa730f)
  • usm: enable responsive behavior (#3494) (76db2a5)
  • remove browser support for IE11 (#3382) (e151c87)

Reverts

BREAKING CHANGES

  • Internet Explorer 11 is no longer supported
2024-01-19

New event parameter for Shield Suspicious Location alert

Along with the release of Shield Suspicious Location: Automated Response we added rule_response_action parameter in the Shield Alert Event response. This parameter is returned in the payload of each Shield Alert Event, but applicable only to Suspicious Locations alert event.The value of the parameter depends on the Restrict Target User Access rule settings in the Admin Console.
  • If active, the value of the parameter will be true when the alert is triggered.
  • If inactive, the value of the parameter will be false when the alert is triggered.
For all other Shield Alerts (Anomalous Download, Malicious Content, Suspicious Session), the rule_response_action parameter is always null.For additional information, see Suspicious Location rule settings

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2024-01-16

Box Java SDK v4.7.0 released

New Features and Enhancements

  • Add signer_group_id for signer in sign request (#1220) (f560db8)
  • Upgrade BouncyCastle to v.1.70.
    NOTE: A new BouncyCastle version is not compliant with FIPS.
  • Introduce IPrivateKeyDecryptor to allow using custom cryptography provider (#1226) (727e6d7)

Bug Fixes

2023-12-11

Introducing enhanced My Apps view in Developer Console

To improve application management experience even further, we introduce the My Apps list view in the Developer Console. This view includes key information about your applications, giving you the possibility to:
  • view and copy the application client ID,
  • view the application description,
  • sort custom applications,
  • check the authorization and enablement status of the application,
  • access the configuration and generate developer tokens.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-11-30

Introducing the NEW Learn Box Platform section

To improve the getting started experience, we have reorganized and added resource materials for you to use when coming on to the platform. Checkout the learn section here.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-11-29

Box Windows SDK v5.6.1 released

Bug Fixes:
  • support object value in BoxConflictErrorContextInfo (#930) (496f758)
2023-11-08

Box Node SDK v3.4.2 released

Bug Fixes

2023-11-08

Box CLI v3.12.2 released

Bug Fixes

2023-11-06

Box CLI v3.12.1 released

Bug Fixes

  • force offset based pagination in get users (#504) (9bed083)
2023-11-03

Box Node SDK v3.4.1 released

Bug Fixes

  • Update proxy-agent usage, drop support Node 12 (#865) (e229d3f)
2023-11-03

Box Node SDK v3.4.0 released

New Features and Enhancements

  • Add request option to skip PassThrough (#863) (726db45)
2023-11-02

Box Java SDK v4.6.1 released

Dependency Upgrades

2023-10-26

Box Node SDK v3.3.0 released

New Features and Enhancements

  • Replace request library with @cypress/request (#860) (d365ae8)

Bug Fixes

  • mark auth functions callbacks as optional (#858) (55f22fe)
2023-10-18

Box Python SDK v3.9.2 released

Bug Fixes

  • Remove restriction to version <2 of urllib3 library (#851) (1dcd82e)
2023-10-06

Introducing Box Platform Glossary

To improve your experience with Box Platform and Box documentation, we created the Box Platform Glossary. You can find there terms and concepts that are most important to start working with Box content- and cloud-based solutions.As we want this list of terms to be comprehensive and detailed, it will be regularly updated. Let us know if you have any suggestions!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-10-06

Box Node SDK v3.2.1 released

Bug Fixes

2023-10-03

Platform Insights for applications

Admins and co-admins can now use the Platform Insights dashboard to get comprehensive view of the organization’s platform usage, including application-related information. With Platform Insights you can check the API call volume or the number of applications that are not enabled or approved yet. Additionally, you can see which apps are the most popular ones in you enterprise.For details, see applications and Platform Insights documentation.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-10-02

Salesforce Toolkit - Integration Mappings

You can now use integration mappings in Salesforce Toolkit with new methods and flow actions. With integration mappings you can map a Slack channel to any folder within your enterprise instead of the default one.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-09-29

Introducing Beta Release: New Generation Python SDK

We are excited to introduce the latest generation (currently in Beta) of Box Python SDK, designed to elevate the developer experience and streamline your integration with the Box Content Cloud.With the new generation of Python SDK, you’ll have access to:
  • Full API Support: The new generation of Box SDKs empowers developers with complete coverage of the Box API ecosystem. You can now access all the latest features and functionalities offered by Box, allowing you to build even more sophisticated and feature-rich applications.
  • Rapid API Updates Say goodbye to waiting for new Box APIs to be incorporated into the SDK. With our new auto-generation development approach, we can now add new Box APIs to the SDK at a much faster pace (in a matter of days). This means you can leverage the most up-to-date features in your applications without delay.
  • Embedded Documentation: We understand that access to information is crucial for developers. With our new approach, we have included comprehensive documentation for all objects and parameters directly in the source code of the SDK. This means you no longer need to look up this information on the developer portal, saving you time and streamlining your development process.
  • Enhanced Convenience Methods: Our commitment to enhancing your development experience continues with the introduction of convenience methods. These methods cover various aspects such as authentication, chunk uploads, exponential back-offs, automatic retries, type checkers which help to ensure that you’re using variables correctly, and much more.
Embrace the new generation of Box SDKs and unlock the full potential of the Box Content Cloud. Start building innovative solutions faster and more efficiently. Happy coding!
2023-09-29

Introducing Beta Release: New Generation TypeScript SDK

We are excited to introduce the latest generation (currently in Beta) of Box TypeScript SDK, designed to elevate the developer experience and streamline your integration with the Box Content Cloud.With the new generation of Typescript SDK, you’ll have access to:
  • Full API Support: The new generation of Box SDKs empowers developers with complete coverage of the Box API ecosystem. You can now access all the latest features and functionalities offered by Box, allowing you to build even more sophisticated and feature-rich applications.
  • Rapid API Updates: Say goodbye to waiting for new Box APIs to be incorporated into the SDK. With our new auto-generation development approach, we can now add new Box APIs to the SDK at a much faster pace (in a matter of days). This means you can leverage the most up-to-date features in your applications without delay.
  • Embedded Documentation: We understand that access to information is crucial for developers. With our new approach, we have included comprehensive documentation for all objects and parameters directly in the source code of the SDK. This means you no longer need to look up this information on the developer portal, saving you time and streamlining your development process.
  • Enhanced Convenience Methods: Our commitment to enhancing your development experience continues with the introduction of convenience methods. These methods cover various aspects such as authentication, chunk uploads, exponential back-offs, automatic retries, type checkers which help to ensure that you’re using variables correctly, and much more.
Embrace the new generation of Box SDKs and unlock the full potential of the Box Content Cloud. Start building innovative solutions faster and more efficiently. Happy coding!
2023-09-29

Box Java SDK v4.6.0 released

New Features and Enhancements

Bug Fixes

  • Added protected accessors for trust manager and hostname verifier. (#1206) (0c79d17)
  • fix not closing response body (#1208) (ab5e170)
2023-09-25

Box Windows SDK v5.6.0 released

New Features and Enhancements:
  • Support iframeable_embed_url for sign request (#925) (e9de994)
2023-09-18

Box CLI v3.12.0 released

New Features and Enhancements

2023-09-14

Box Python SDK v3.9.1 released

Bug Fixes

  • do not retry creating a ZIP when response code is 202 (#845) (3f6ed4e), closes #844
2023-09-14

Box Java SDK v4.5.0 released

New Features and Enhancements

  • Add iframeable_embed_url field to BoxSignRequestSigner class (#1202) (2e931d8)

Bug Fixes

2023-09-07

Box Windows SDK v5.4.0 released

New Features and Enhancements:
  • Support Sign Templates and new Sign Request statuses (#920) (78580fb)
2023-09-07

Box Node SDK v3.2.0 released

New Features and Enhancements

2023-09-06

Box Python SDK v3.9.0 released

New Features and Enhancements

Bug Fixes

  • ChunkedUploader Resume Not Closing ThreadPoolExecutor Instances (#840) (f210f00)
2023-09-04

Box Windows SDK v5.3.0 released

New Features and Enhancements:
  • add attachment content type to SignRequestSigner (#913) (ad612ff)
Bug Fixes:
  • replace deprecated BouncyCastle library (#909) (f00f2af)
2023-08-29

Box Java SDK v4.4.0 released

New Features and Enhancements

  • Support sign template and new sign status (#1197) (e37c0dc)
2023-08-16

Introducing Embedded Box Sign Client

You can now use Box Embed to embed Box Sign features in your own website. This way, users don’t have to leave the website, go to Box Sign to sign the document, and then come back to finish the process. Instead, Box Embed allows them to complete the signing process within the external website.To integrate Box Sign experience within your own website, you need the iframeable_embed_url parameter that is specifically designed to allow signing documents within the HTML iframe tag.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-08-16

Box CLI v3.10.0 released

New Features and Enhancements

2023-08-11

Box Java SDK v4.3.0 released

New Features and Enhancements

2023-08-08

Box iOS SDK v5.5.0 released

New Features and Enhancements

  • Add missing values in SignRequestSignerInputContentType and SignRequestStatus along with the tests (#907) (56a8250)

Bug Fixes

  • Identify iPhone Simulator on Apple Silicon (#902) (7731a7f)
  • Make code compatible with macOS. (#900) (3b0016e)
  • Remove use of deprecated string scanner API. (#901) (af5f0e5)
2023-08-08

Box CLI v3.9.2 released

Bug Fixes

  • Fix escaped slashes when passing an input to command (#486) (7670210)
2023-08-03

Box Java SDK v4.2.1 released

Bug Fixes

2023-08-01

Box Python SDK v3.8.1 released

Bug Fixes

  • Fix JSON response validation retry strategy (#831) (69834eb)
2023-07-25

Box Python SDK v3.8.0 released

New Features and Enhancements

  • Support updating all fields of collaboration (#829) (6dc7ecc)
2023-07-26

Improvements in App Access Level for JWT authentication

You can now ensure access to enterprise Managed Users and groups that were not created by apps authenticated with JWT. To do so, set App Access Level to App + Enterprise Access in the Configuration tab of the Developer console.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-07-19

Box Node SDK v3.1.1 released

New Features and Enhancements

  • Bump proxy-agent to version 6.3.0 (845) (3f89f83)
2023-07-19

Box CLI v3.9.1 released

New Features and Enhancements

  • Bump version of box-node-sdk and csv libraries (483) (fecb04b)
2023-07-12

Sign Request API improvements

Sign Request status parameter now has two additional values:
  • finalizing to reflect the state when all signers have signed the request, but the final document with signatures and the signing log has not been generated yet.
  • error_finalizing to reflect the state when the finalizing phase did not complete successfully.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-07-12

Box UI Elements v18.1.0 released

18.1.0 (2023-07-12)

Bug Fixes

Features

  • uaa-integration: Filter activity types for UAA (#3369) (b9d196f)
2023-07-07

Box Python SDK v3.7.3 released

Bug Fixes

  • Stop processing data for logging when logging is deactivated and cache response json (#824) (3079171)
2023-06-30

Updated sorting of folder items for shared folders

Box Folder API allows you to retrieve the items in the folder and sort this list based on the sort parameter. We have improved the way items are sorted for shared folders that have the path to the associated folder visible to the collaborators.Earlier, the items for such folders were sorted by id regardless of the sort parameter value. Currently, they are sorted based on the sort parameter.

New place to get support

From now on you can ask questions and seek for guidance in our new Box Developer Community forum. Use this new space to directly speak to the Box Developer Relations team, as well as your peers and other subject matter experts from Box.
2023-06-27

Box UI Elements v18.0.0 released

18.0.0 (2023-06-27)

Bug Fixes

  • ci: remove blank space from release script var (#3355) (2553ec1)
  • content-explorer: increase grid button style specificity (#3328) (b2c878a)
  • content-explorer: map called on undefined object (#3341) (da6ada0)
  • content-picker: trim name input when creating folder (#3364) (4629726)
  • css: remove IE7 CSS hack to fix Parcel support (#3368) (cbff7f1)
  • i18n: update translations (#3323) (c810383)
  • i18n: update translations (#3344) (755d64b)
  • i18n: update translations (#3349) (6ba9f27)
  • i18n: update translations (#3351) (4ff75e8)
  • i18n: update translations (#3352) (80c795a)
  • i18n: update translations (#3359) (c94305c)
  • preview: update thumbnail sidebar width (#3363) (33c8236)
  • sharing: remove message for shared links for Canvas files (#3337) (9558474)
  • align viewer permissions for shared links (#3335) (5d78c11)
  • update dist path and react version for elements test pages (#3350) (38ff124)
  • pill-selector-dropdown: pass showAvatars prop to RoundPill (#3329) (5632743)
  • share-form: map called on undefined object (#3340) (a24abb2)
  • usm: fix message for upgrade notice in share modal (#3334) (4a945ce)

chore

Features

  • cloud-game: Adjust cloud game visual (#3361) (fe7fb51)
  • pill-selector-dropdown: allow setting error tooltip position (#3330) (8df1551)
  • preview: update default Preview SDK version (#3366) (aa7a875)
  • security-controls: Remove watermark learn more link (#3353) (379d055)
  • threaded-replies: reply to annotations (#3331) (4f65525)
  • uaa-integration: Integrate UAA into ActivitySidebar (#3316) (b81e976)

BREAKING CHANGES

  • deps: You need to upgrade react-beautiful-dnd in the consuming project to version 11.0.5
  • node: Upgrade to node 18
2023-06-26

Integration mappings for Slack

Learn how the Box Enterprise Admin (EA) can customize the upload folder of the Slack channel to any folder within the enterprise instead of relying on the default one with the Integration Mappings for Slack guide.Use Box API to create, list, update, and delete the Slack Integration Mappings.Using the automation script, an admin can create or update multiple mappings at once!Check the Troubleshooting section to find out solutions to most common issues you can encounter.

New place to get support

From now on you can ask questions and seek for guidance in our new Box Developer Community forum. Use this new space to directly speak to the Box Developer Relations team, as well as your peers and other subject matter experts from Box.
2023-06-21

Box Java SDK v4.2.0 released

New Features and Enhancements

  • Getting collaborators allows to specify fields (#1178) (1694d75)
2023-06-15
We have enhanced our password policy for creating shared links with Box API, for example when adding a shared link to a file. Passwords must now be at least eight characters long and include:
  • a number,
  • upper case letter, or
  • non-alphabetic or non-numeric character

New place to get support

From now on you can ask questions and seek for guidance in our new Box Developer Community forum. Use this new space to directly speak to the Box Developer Relations team, as well as your peers and other subject matter experts from Box.
2023-06-14

Box Java SDK v4.1.2 released

Bug Fixes

2023-06-13

Join Box Developer Community

Exciting news for developers and admins! Box has launched the Box Developer Community site, where you can connect with peers and experts to build innovative applications on top of the Box cloud content management and collaboration platform. Join us today at https://forum.box.com!

Join, connect and learn

  • Get support and provide feedback
  • Share knowledge and become a community leader
  • Connect and chat with other Box developers and admins
  • Learn from other community members and Box subject matter experts
  • Stay up to date with the newest features, updates, developer-focused events, blog posts, and more!

New place to get support

From now on you can ask questions and seek for guidance in our new Box Developer Community forum. Use this new space to directly speak to the Box Developer Relations team, as well as your peers and other subject matter experts from Box.
2023-06-02

Box CLI v3.9.0 released

New Features and Enhancements

  • add max-items, improve list endpoints performance (#470) (8f386f3)
  • Add support for Integration Mappings API (#472) (bbf2548)
  • New fields in retention-policy and retention-policy-assignment (#466) (f960e59)
2023-06-01

Box Node SDK v3.1.0 released

New Features and Enhancements

  • Added support for integration mappings API (#831) (a525327)

Bug Fixes

  • Correct types of userId and groupId for creating collaboration (#833) (f803ff8), closes #832
2023-05-26

UI Elements in Box for Salesforce managed package

With the Box for Salesforce managed package you can use the following UI Elements as Lightning Components: content picker, explorer, preview, and uploader. You can use them on Lightning Pages, or in Flows.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-05-26

Box Python SDK v3.7.2 released

Bug Fixes

2023-05-24

Integration mappings API

With integration mappings, you can manage where content from partner apps is stored in Box.This feature currently only supports Box as Content layer for Slack.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-05-23

Box Windows SDK v5.2.2 released

Bug Fixes:
  • catch exception when .net core version cannot be determined (#906) (e3be209)
2023-05-23

Box Node SDK v3.0.0 released

The most important change in this release is dropping support for Node versions below 12 and changing the support environments from Node 12 to Node 16.

Breaking Changes

  • Removed use_index usage. (#812) (d56799a)
  • Removed deprecated BoxClient.batch() and BoxClient.batchExec() method.
  • Removed deprecated CollaborationWhitelist class, use CollaborationAllowlist instead.
  • Removed deprecated CollaborationAllowlist.getWhitelistedDomain() method, use CollaborationAllowlist.getAllowlistedDomain() instead.
  • Removed deprecated CollaborationAllowlist.getAllWhitelistedDomains() method, use CollaborationAllowlist.getAllAllowlistedDomains() instead.
  • Remove deprecated Files.getThumbnail(fileID: string, options?: Record<string, any>, callback?: Function) method, use Files.getRepresentationContent( fileID, representationType, options, callback) instead.
Migration details can be found here

Dependency Upgrades

2023-05-16

Box Java SDK v4.1.1 released

Bug Fixes

  • Allow users to disable adding authentication header. (#1167) (3433e5a)
  • Logging headers when retrying request (#1164) (e0c3d8e)
2023-05-11

Box Node SDK v2.10.0 released

New Features and Enhancements

  • Added support for ethical wall API (#822) (4814af3)
  • Added name and signature_color fields to SignRequest and SignRequestCreateRequest types and login_required field to SignRequestCreateSigner type (#822) (4814af3)
2023-05-10

Box UI Elements v17.1.0 released

17.1.0 (2023-05-10)

Bug Fixes

  • content-explorer: select all checkbox in empty folder (#3324) (a193adb)
  • content-explorer: select all checkbox state matches selectedItems (#3319) (7473dfd)
  • i18n: update translations (#3313) (dd9a1fd)
  • i18n: update translations (#3317) (95618cf)
  • pill-selector-dropdown: remove default value for isPositionDynamic (#3320) (e74f824)
  • preview: videos not loading on edge (#3326) (e5aa7e5)
  • usm: make item prop optional (#3322) (fe7c4bb)

Features

  • sharing: Change message for shared links for Canvas files (#3315) (fa17afd)
  • sharing: Change message for shared links for Canvas files (#3318) (60a3a6e)
2023-05-10

Box Sign template APIs

The new Box Sign template APIs allow you to get a list of Box Sign templates or details of a specific Box Sign template. You can then use this information to initiate template-based sign requests.

Where to get support

Should you have any issues or need further guidance, post a request to our developer forum for any help needed.
2023-05-26

Updates to File Upload API

In response to a potential security vulnerability while uploading a file using Upload File API and downscoped token, we’re updating the Upload File API to return a 404 error in scenarios where the parent Folder ID is found, but the requester does not have permissions to access it.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-04-24

Box Java SDK v4.1.0 released

New Features and Enhancements

  • Add missing fields parameter to create and update BoxUser methods (#1155) (be3820d), closes #1154

Bug Fixes

  • Allow registering custom logger handlers (#1156) (7373d5c)
  • Fallback to default value of maxRetryAttempts when restoring BoxAPIConnection (#1161) (2a10e5d), closes #1160
2023-04-20

Box UI Elements v17.0.0 released

17.0.0 (2023-04-20)

Bug Fixes

  • aci-toggle: info badge vertical alignment (#3290) (f73b9f9)
  • avatar: Add aria-label to external user icon (#3263) (18cdf3f)
  • collaborator-list-item: remove redundant titles (#3255) (d805249)
  • content-explorer: add arrow navigation (#3219) (35bf8de)
  • content-explorer: Add svg titles to icons (#3227) (506ca45)
  • content-explorer: change color of folder tree breadcrumbs text (#3268) (fc95d4d)
  • content-explorer: enable create folder with trailing space in name (#3246) (e0b03c7)
  • content-explorer: Fix color contrast issue for item details (#3273) (4db0231)
  • content-explorer: Fix color contrast issues (#3221) (b7ecaab)
  • content-explorer: fix item list column header role (#3232) (718a71a)
  • content-explorer: focus border on selected item row buttons (#3314) (a596557)
  • content-explorer: hide instead of deactivate breadcrumbs (#3260) (5b5fec1)
  • content-explorer: Include subfolders sub-header fix (#3259) (6ec1512)
  • content-explorer: status message for include subfolders (#3261) (3ce688d)
  • content-explorer: Update Share button border on selected row (#3278) (28c79dd)
  • content-picker: add disabled attribute (#3243) (a88a96c)
  • content-sharing: removed API condition when constructing API (#3251) (24dcba2)
  • content-uploader: make deactivated buttons unfocusable (#3248) (2302712)
  • flyout: increase flyout overlay CSS specificity (#3257) (0933062)
  • i18n: update translations (#3250) (d84d1ca)
  • i18n: update translations (#3276) (018a99c)
  • i18n: update translations (#3285) (bfbcf55)
  • i18n: update translations (#3300) (88116cb)
  • itemlist: Remove header section when list is empty (#3224) (0274618)
  • makeselectable: Prevent arrow hotkeys on slider (#3299) (a893e5a)
  • metadata: fix template drop-down truncation issue (#3265) (c3ae099)
  • select-field: Add bottom margin when drop-down has top placement (#3302) (11e6979)
  • select-field: add tether class for select drop-downs (#3303) (ce27f70)
  • selector-dropdown: add dynamic positioning to the drop-down overlay (#3262) (7f05653)
  • usm: Order person before icon in collaborator list DOM (#3306) (32c656d)
  • add props to omit to avoid console warnings (#3286) (11328fb)
  • Align menu options in BE sort button (#3231) (dcc06e2)
  • Fix aria-label for BE header search (#3244) (ca01965)
  • Replace bdl-gray-62 for USM and Shared Link components (#3289) (1f25b98)
  • makeselectable: shift and arrow selects first row (#3223) (9b209e5)
  • scss: Replace all division for dart-sass (#3253) (ac92e21)
  • shared-link-section: accessibility tooltip (#3216) (4ecdd81)
  • sub-header: sort menu item accessibility (#3230) (20f4454)
  • sub-header: update sort to use select component and update tests (#3239) (528a157)
  • toggle: add switch role (#3254) (cf0c894)
  • tooltip: Deactivate aria-describedby when ariaHidden is true (#3233) (d9108c4)
  • tooltip: tooltip should be dialog (#3226)” (#3264) (fa68dd6)
  • usm: Remove aria-label and add aria-haspopup (#3281) (fd1a82d)
  • usm: Removing redundant button element (#3282) (a7005ff)
  • change type of buttons in Content Sharing from ‘submit’ to ‘button’ (#3277) (26b7e5f)
  • Improve color contrast for input borders (#3234) (3917bee)
  • Improve color contrast for placeholder text (#3228) (1f7b9f9)
  • Update box-shadow for inputs (#3236) (07cc347)
  • assets: Use correct icons after icons were renamed (#3138) (2c80164)
  • content-explorer: add aria-label for MoreOptions button (#3197) (f4b69f0)
  • content-explorer: add aria-label to grid slider (#3189) (e3900b3)
  • content-explorer: create default shared link when none exists (#3209) (5d05a2b)
  • content-explorer: Pass all props from modalContainer to Modal (#3104) (5d5b314)
  • content-explorer: Remove props from styleguidist examples (#3146) (1f0809b)
  • content-picker: add accessible names to Footer (#3177) (bd8e1e6)
  • content-sidebar: reply operations interactions (#3103) (9400f5a)
  • content-sidebar: reply operations interactions (#3123) (8d2c3f1)
  • content-sidebar: select and hover state for threaded feed items (#3173) (a7dc6a9)
  • content-uploader: fix UploadInput keyboard accessibility (#3205) (e918b5f)
  • dropdown-menu: fix positioning for responsive drop-down menu (#3149) (729f6f1)
  • grid-view: unhide focus outline for grid view slider (#3212) (b35e977)
  • i18n: update translations (#3105) (b8521e4)
  • i18n: update translations (#3111) (29fc19c)
  • i18n: update translations (#3121) (16bc077)
  • i18n: update translations (#3130) (8ca714b)
  • i18n: update translations (#3135) (53c0370)
  • i18n: update translations (#3137) (7fe32a6)
  • i18n: update translations (#3139) (82f414d)
  • i18n: update translations (#3150) (d428a43)
  • i18n: update translations (#3158) (02eb624)
  • i18n: update translations (#3159) (6df6f0d)
  • i18n: update translations (#3174) (0e9ea9d)
  • i18n: update translations (#3183) (c32bbae)
  • i18n: update translations (#3199) (eb1acee)
  • i18n: update translations (#3207) (d9d571d)
  • i18n: update translations (#3213) (64364c3)
  • i18n: update translations (#3220) (39739ab)
  • i18n: update translations (#3222) (429c856)
  • item-action: add aria-label to PlainButton (#3180) (2553713)
  • item-remove: add aria-label (#3181) (0fce635)
  • menu: fix long title in menu header (#3125) (79420f2)
  • modal: Modal header for long file names was displaying incorrectly (#3108) (d8321aa)
  • react-virtualized: Bumped react-virtualized (#3160) (b256b07)
  • react-virtualized: remove duplicate a11y label (#3204) (c67a4dd)
  • react-virtualized: Remove role for Table_Grid_innerScrollContainer (#3218) (cabb4a8)
  • replies: fix total_replies_count value update after delete reply (#3147) (8f75827)
  • sharedlinksettings: fix expiration timestamp (#3179) (1a698c5)
  • sub-header: add accessibility label to SortButton (#3178) (ba66a34)
  • threaded-replies: deactivate reply button for pending status (#3186) (efbc532)
  • threaded-replies: fix styling for replies (#3110) (f78e36b)
  • tooltips: Error tooltips were being truncated on smaller screens (#3107) (7e12d88)
  • usm: add aria label (#3191) (f1f5c81)
  • usm: add aria-label to expiration icon (#3193) (af3c567)
  • usm: add aria-label to tooltip close button (#3211) (529bf10)
  • usm: add role img to shared link expiration tooltip icon (#3195) (a79e193)
  • usm: tooltip should be dialog (#3226) (f52ad0e)
  • remove warning when passing initialSelectedItems to ContentExplorer (#3151) (bf3256a)

Code Refactoring

Features

  • aci-toggle: add separate prop for description (#3307) (cadab1d)
  • aci-toggle: UI adjustments (#3297) (84f9abb)
  • annotation: Add icon indicator for AnnotationActivity (#3176) (f773aa3)
  • annotation-activity: hide AnnotationActivityLink (#3089) (dc3642e)
  • annotation-thread: added reply form, UI and other minor fixes (#3157) (55ca058)
  • annotation-thread: Annotation thread comments visual fixes (#3128) (fac5133)
  • annotation-thread: annotation thread events handling (#3196) (1c07b41)
  • annotation-thread: annotation thread related hooks refactoring (#3192) (0168f1a)
  • annotation-thread: annotation thread replies events handling (#3201) (3df222a)
  • annotation-thread: introduce useAnnotationThread and handle useAnnotatorEvents (#3097) (a8d1985)
  • annotation-thread: use of event emitter and hooks refactoring (#3184) (cfed356)
  • annotations: hide AnnotationActivityLink based on hasVersions prop (#3132) (3469413)
  • assets: update cancellation flow assets (#3117) (42e1122)
  • checkbox: allow stopPropagation on onClick events (#3122) (9c25858)
  • checkbox: make focus behavior configurable (#3214) (18b8ea6)
  • checkbox: prop to add class to input (#3194) (e0cc12d)
  • checkbox: revert allow stopPropagation on onClick events (#3127) (e37de34), closes #3122
  • cloud-game: Add accessibility to security cloud game (#3086) (684e9f6)
  • collapsible-sidebar: add prop to hide Box logo (#3256) (43279c0)
  • collapsible-sidebar: add wrapperClassName prop (#3295) (2cde065)
  • content-explorer: adding folder tree (#3240) (03b0dea)
  • content-explorer: Allow selecting empty selection in ContentExplorer (#3175) (fead6e4)
  • content-explorer: clickable status message for include subfolders (#3266) (3d8eaf8)
  • content-explorer: include subfolders toggle (#3242) (b75c7ee)
  • content-sidebar: add on fetch file callback function (#3118) (5373031)
  • content-sidebar: added support for active comment reply (#3134) (3ef81e1)
  • content-sidebar: hide “edited” for resolved comment/annotation (#3152) (07f5fc7)
  • content-sidebar: select and hover state for threaded feed items (#3162) (a6c125d)
  • input-with-copy: add node for settings button (#3267) (719b31f)
  • insights: Added support for Advanced Content Insights (#3116) (a66ec89)
  • left-nav: Update medium width in \_sizes.media.scss (#3131) (aaf112d)
  • list-view: List View item hover state changes (#3115) (103a5d1)
  • make-selectable: Add select click functionality to on checkbox click (#3112) (ffc2e33)
  • make-selectable: expose selectToggle function (#3109) (8d9fb90)
  • mediaquery: add isTouchScreen logic (#3269) (3e80a06)
  • modal: add callback to check permission on shared link load (#3188) (2b316db)
  • preview: add new sign drop-down under ff (#3190) (37e8a19)
  • threaded-replies: Create Replies component (#3288) (006e33c)
  • threaded-replies: Create RepliesToggle component (#3294) (92d0ddb)
  • threaded-replies: Create Reply button component (#3298) (f9d4130)
  • threaded-replies: Decouple ActivityCard from Comment (#3279) (7d1d3bf)
  • threaded-replies: Implement Create Replies and Replies Toggle (#3304) (044a336)
  • threaded-replies: Refactor Comment component to functional (#3270) (3900d1c)
  • threaded-replies: Update activity filter to support more options (#3280) (76e4010)
  • add additionalColumns prop to ContentExplorerModalContainer (#3143) (d4eea59)
  • Add option to display header in ContentExplorerModalContainer (#3144) (5685142)
  • Add optional tether props to DropdownMenu (#3245) (9db75e7)
  • threaded-replies: fix styling for resolve (#3129) (b291c50)
  • threaded-replies: keep replies visible when loading more replies (#3133) (295533c)
  • tooltip: support error tooltip position (#3187) (941e990)
  • add rowHeight prop to ContentExplorerModal (#3140) (476d739)

Reverts

  • “chore(answers): added foundation for content-answers element … (#3249) (56f58a5), closes #3247
  • annotation-activity: hide AnnotationActivityLink (#3120) (ba22807), closes #3089

BREAKING CHANGES

  • bdl-gray-62 is replaced with bdl-gray-65
2023-04-20

Updates to Box Embed guide

With Box Embed you can embed a Box webapp anywhere in your application. The updated webapp is responsive to any changes. For example, if an integration makes the embedded Box webapp smaller, all the UI components such as buttons and lists will also be resized to still be usable.The update also includes a description of the cloud game, a widget which increases security by preventing clickjacking.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-04-19

Box Node SDK v2.9.0 released

New Features and Enhancements

  • New fields in retention-policy and retention-policy-assignment (#803) (f14ba84)

Bug Fixes

  • return empty object when tos status is not present (#797) (12fd9b0)
2023-04-19

Box iOS SDK v5.4.2 released

Bug Fixes

  • An empty string nextMarker should be treated as end-of-paging. (#893) (49c17de)
2023-04-18

Box Windows SDK v5.2.1 released

Bug Fixes:
  • Catch all exceptions when getting User Agent header (#901) (75d8874)
2023-04-18

Box Python SDK v3.7.1 released

Bug Fixes

  • Rename filter date parameters in legal hold creation according to the documentation (#810) (f52c66a)
2023-04-17

Add more details to Custom Apps

To clarify Custom Apps’ purpose and add the value for the enterprise, we now offer a possibility of describing the Custom App in a more granular way.When setting up a Custom App with OAuth, JWT or Client Credentials, you can now specify the purpose of the app and the app’s creator. Additionally, if you intend to integrate your app with an external system, you can define the integration category and provide details of the external system.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-03-28

Collaborations API - pending status

We added more information about the pending status in our collaborations API.If the collaboration is in pending status:
  • login and name return an empty string,
  • the following fields are redacted:
    • login and name are hidden if a collaboration was created using user_id,
    • name is hidden if a collaboration was created using login.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-03-14

Box Windows SDK v5.2.0 released

New Features and Enhancements:
  • add Id to MetadataTemplateField (#890) (b7fe214)
  • add start_date_field and description to retention policies (#888) (100b722)
  • add configurable JWTAudience claim (#897) (50219fd)
  • add shared link support to GetFolderItemsAsync (#892) (0eba85c)
Bug Fixes:
  • Use fixed value of aud field in JWT claim (#896) (8c9982d)
2023-03-08

Downloading ZIP Archives with Box API

A recently released guide helps you to download large amount of data. Use Box API to create and download ZIP archives containing files, folders, or both.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-03-08

Box Python SDK v3.7.0 released

New Features and Enhancements

  • Add new optional fields for retention_policies and retention_policy_assignments (#803) (8b72f7e)
  • Use multiple threading for chunked upload (#800) (506ce0d)
2023-03-06

Box Java SDK v4.0.1 released

Bug Fixes

  • OAUTH_SUFFIX gets appended twice to baseAuthorizationURL (#1148) (3164770), closes #1147
  • Wrong progress reported to ProgressListener by AbstractBoxMultipartRequest (#1151) (947ded3), closes #1149
2023-03-03

Box CLI v3.8.0 released

New Features and Enhancements

  • add alias for metadata cascade policy create (#460) (8d2f683)
  • Add support for --reauthorize flag in login command (#457) (f653a0d)

Bug Fixes

2023-02-24

Box iOS SDK v5.4.1 released

Bug Fixes

  • Fix listAssignments and assign methods in RetentionPolicyModule (#886) (b668888)
2023-02-24

Announcing End of Support for Android SDK on May 31st

As of May 31, 2023 Android SDK will no longer be supported. You can still use your existing Android SDK applications with no impact, but you won’t receive new features, updates, or bug fixes. If you would like to continue getting the latest and greatest Android features, we recommend using Java SDK to build apps on Android. Refer to this documentation for more details.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-02-23

Box Sign updates

Multiple documents in one request

The Box Sign multiple documents in one request is now supported in our public API.

Signer attachments

The signer attachments feature allows users to request additional files from signers in a file attachment field.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-02-08

The Sample Code Catalog released

We are happy to announce that the Sample Code Catalog v1.0.0 is now available on our Box Developer site. From now on you can browse code samples in various programming languages and filter them by category.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-02-07

Box Python SDK v3.6.2 released

Bug Fixes

  • Retry Connection broken and Connection reset requests errors (#794) (f1a0aa4)
2023-01-19

Box CLI v3.7.0 released

New Features and Enhancements

  • Add more flags for folder update collaborators (#438) (83ac6d7)
  • Add support session termination (#446) (aef15a8)

Bug Fixes

  • Fix delete token cache from disk (#445) (aafb68a)
  • Fix metadata template update when adding multiple options to enum (#442) (8779eec)
  • single file upload on Node 16 (#441) (d94ab35)
2023-01-18

Box Java SDK v4.0.0 released

The most important change this release includes is the replacement of the HTTP library from a native one to OkHttp which allows SDK to
  • Support the HTTP2 version of the HTTP protocol.
  • Support proxies that do not use only basic authentication method. For details on creating custom proxy authenticators and an example of NTLM proxy authentication.

Breaking Changes

  • BatchAPIRequest is no longer supported by the SDK
  • BoxAPIConnection#DEFAULT_MAX_ATTEMPTS is replaced with BoxAPIConnection#DEFAULT_MAX_RETRIES
  • BoxRedirectResponse was removed and will not be replaced
  • BoxEvent.Type is replaced with EventType
  • Removed deprecated methods from BoxFile, BoxFileVersionRetention, BoxFolder, BoxGroup, BoxGroupMembership,BoxItem, BoxRetentionPolicy, BoxTask, BoxUser, BoxWebLink, EventLog, Metadata and MetadataTemplate.
Migration details can be found here.

New Features and Enhancements

2023-01-17

Box Windows SDK v5.1.0 released

New Features and Enhancements:
  • BoxCCGAuth add User and Admin clients factory methods without initial token (#883) (c1337fc)
2023-01-12

Box Windows SDK v5.0.0 released

⚠ BREAKING CHANGES
  • upgrade .net framework to 4.6.2 (#881)
  • remove deprecated methods (#881)
  • remove use_index references (#881)
  • return proper object from GetFileVersionsUnderRetentionForAssignmentAsync(#881)
New Features and Enhancements:Bug Fixes:
  • Added pagination option to IBoxFilesManager#ViewVersionsAsync (#869) (2324495), closes #866
  • return proper object from GetFileVersionsUnderRetentionForAssignmentAsync (#881) (f1989aa), closes #875
2023-01-11

Salesforce Toolkit - Flow Actions

Salesforce toolkit includes wrappers that allow admins to invoke the following methods. It allows Box for Salesforce users to build automated solutions, such as folder structure, using Salesforce Flows.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2023-01-09

Box Python SDK v3.6.1 released

Bug Fixes

  • Retry CCG and JWT auth requests on connection reset error (#790) (205997d), closes #789
2023-01-05

Box Node SDK v2.8.1 released

Bug Fixes

2023-01-04

Box Java SDK v3.8.2 released

Bug Fixes

  • Fixed restoring state without refresh token. (#1139) (3544709)
2023-01-03

Box Python SDK v3.6.0 released

New Features and Enhancements

Bug Fixes

  • Fix index error when getting an empty list of user term of service statuses (#780) (23d763a)
  • Specify which exceptions should be retried (#784) (833cd46)
2022-12-21

Box Node SDK v2.8.0 released

New Features and Enhancements

2022-12-19

Announcing major releases of Box SDKs

In January 2023, we plan two major releases of Box Windows V2 SDK and Box Java SDK.For Box Windows V2 SDK, we are changing the minimum supported version of .NET Framework from 4.5 to 4.6.2+. For Box Java SDK, we are replacing networking library and introducing OkHttp which will give SDK support of HTTP2 protocol and allow users to use proxies beyond basic authentication.For both SDKs, we are removing deprecated APIs.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-12-19

Box Java SDK v3.8.1 released

Bug Fixes

  • Restoring state from previous SDK version works. (#1134) (b6d97dd)
2022-12-01

Server-side actions no longer supported in Web App Integrations

On December 1st, the options to create a preliminary callback URL or a server-side integration will no longer be available for OAuth 2.0 web app integration.

Next steps

If you have the server-side integration already configured for your applications, it will still be working. If you wish to stop using the feature or perform adjustments in your settings, see this document for workaround options and support.For more information about web app integrations, see the documentation.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-11-30

Box Python SDK v3.5.1 released

Bug Fixes

2022-11-22

Box CLI v3.6.0 released

New Features and Enhancements

  • Add id and type field to shared-links:create response (#427) (5ea4cb8)
  • Add fields disposition_at field for files under retention (#429) (db824ef)

Bug Fixes

2022-11-16

Box Java SDK v3.8.0 released

New Features and Enhancements

Bug Fixes

  • NullPointerException when using BoxSignRequestPrefillTag (#1121) (73fd5b6), closes #1120
  • Regenerate JWT ID and retry auth request when JTI claim is rejected (#1110) (420da0f)

Dependency Upgrades

2022-11-10

Box Node SDK v2.7.2 released

Bug Fixes

  • Add fields query parameter to file and folder update (#776) (a327deb)
2022-11-08

Box iOS SDK v5.4.0 released

New Features and Enhancements

  • Add content_type field to Sign Requests signer (#871) (1ec5b01)
  • Add redirect_url and declined_redirect_url to Sign Request (#870) (f94d988)
  • Add support for sign webhook triggers (#875) (994bfaf)
  • Added method to remove retention policy assignment (#873) (c5f146c)
  • Added support for Modifiable Retention Policies (#872) (e2b7a17)
2022-11-02

Box CLI v3.5.0 released

New Features and Enhancements

  • Add option to change name of downloaded file in save-asparameter (#415) (81fe64e)
  • Add support for modifiable retention policies & enable deleting retention policy assignment (#420) (26ab5b4)
2022-10-28

Introducing Shield Information Barrier

Shield information barrier prevents communication that could lead to conflicts of interest or potential legal issues. For example, admins can use information barrier to separate teams working on different projects to prevent collaboration on content restricted to specific groups.

Shield Information Barrier API

Shield information barrier comes along with the new API that you can use to:

Shield Information Barrier Events

Setting up the information barrier produces the following events:
  • Events triggered when the user configures the information barrier, for example activates or deactivates the barrier.
  • Events triggered when the user performs restricted actions, for example attempts to move an item to a restricted folder or add a user to a restricted group.
For a list of all events, see the Shield information barrier event triggers reference.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-10-28

Box Node SDK v2.7.1 released

Bug Fixes

2022-10-27

Box Node SDK v2.7.0 released

New Features and Enhancements

  • Add support for modifiable retention policies & enable deleting retention policy assignment (#769) (5e8c776)
2022-10-20

Box UI Elements v16.0.0 released

16.0.0 (2022-10-20)

Bug Fixes & Features

This release fixes several bugs and adds new features. For a full list of changes, see the release notes.
2022-10-19

Manage webhooks V2 in the developer console

Managing webhooks in your applications is now easier and more streamlined. In one single-stop UI - the Webhooks tab in the Developer Console - you can review all webhooks in an application. You can now create, update, or delete V2 webhooks using the user interface in the Developer Console.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-10-19

New annotations in the Content Preview UI Element

To improve the content previewing experience, we have added support for new annotations types in the Preview UI Element. End users previewing content in custom applications can now utilize additional annotation types, such as text highlight, drawing, and more. All the annotations sync in real time.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-10-18

Box Windows SDK v4.6.0 released

New Features and Enhancements:
  • Add redirect_url and declined_redirect_url to Sign Request (#853) (5ef2f18)
  • Add support for modifiable retention policies & enable deleting retention policy assignment (#856) (564904f)
2022-10-05

Extract metadata with the new Box CLI script

Box CLI now features a new script that allows you to extract metadata details for all Box files and folders and save it in a CSV file.

Where to get support

Should you have any issues or need further guidance, post a request to our developer forum for any help needed.
2022-09-30

Box Java SDK v3.7.1 released

Bug Fixes

  • Better logging when JSON cannot be parsed (#1106) (5e66ef8)
2022-09-26

Box CLI v3.4.0 released

New Features and Enhancements

  • Add DryRun mode in User Deprovision example script (#392) (584a30e)
  • Add redirect_url and declined_redirect_url to Sign Request (#395) (261b7d2)
  • Add progress bar for file download and bulk command (#376) (68359c7)
  • create destination path during download (#393) (40881dd)
  • native credentials storage for Windows with a new library (#385) (a6918aa)

Bug Fixes

  • correctly resolve home dir in folders download (#398) (86d3230)
  • Fix logs in Users Deprovisioning script (#381) (c85f77b)
  • Fix problem with keytar library (#394) (1979f01)

Note

  • To migrate storing Box CLI environments to the system credential storage, execute the following command in the terminal (#295) box configure:environments:update
2022-09-23

Box Python SDK v3.5.0 released

New Features and Enhancements

  • Add redirect_url and declined_redirect_url fields to Sign Request (#752) (5d1f609)
  • Add support for modifiable retention policies & enable deleting retention policy assignment (#759) (847301b)
  • Support file request APIs (#747) (71895e3)

Bug Fixes

  • Do not log the content of downloaded file (#760) (5d26431)
  • Fix closing file after chunked upload (#761) (b433692)
2022-09-23

Box Node SDK v2.6.0 released

New Features and Enhancements

  • Add content_type, redirect_url field to Sign Request (#758) (8abb9b6)
  • Add sign request webhook (#760) (e92d1ab)
  • Added support for Access Only Collaboration (#759) (dd8261f)
2022-09-21

Box Java SDK v3.7.0 released

New Features and Enhancements

  • Add is_accessible_via_shared_link field to File and Folder (#1103) (45e9906)

Bug Fixes

  • BoxCollaboration.getItem() returns BoxItem.Info not BoxFolder.Info (#1102) (135850d), closes #1101 #1100. BoxCollaboration.getItem() used to return BoxFolder.Info. However, if collaboration was added on a file it would still return BoxFolder.Info which will end with throwing BoxAPIException when doing any API call. If you are getting collaboration item it is best to store it as BoxItem.Info or check its type and store it as BoxFile.Info or BoxFolder.Info.
  • Add missing constructor to BoxNotificationEmail class (#1098) (2534f34)
2022-09-12

Improved Guides on Chunked Uploads

To improve your experience with uploading large files in chunks, our guides now provide additional details on the process and support each step with examples.Check out the Upload Part guide a to get the details on how to effectively split files and upload them in several parts using Box API.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-09-07

Box Java SDK v3.6.0 released

New Features and Enhancements

  • Add support for modifiable retention policies & enable deleting retention policy assignment (#1093) (30e2fcb)

Bug Fixes

  • Stop sending not specified optional fields when creating a user (#1095) (b7d894d)
2022-09-06

Box CLI Advanced Features YouTube Video Released

Back in February, we launched the OAuth 2.0 version of the Box CLI, alongside new YouTube content. Today, we released video 3 of the series. It shows using the as-user header and bulk command options.You can find the Box Platform and Developer Playlist on YouTube. We have one more video planned for this series: CLI Automation using PowerShell.Make sure to subscribe to the Box Channel to get all the latest content!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-08-29

Box Sign available for Starter plans

Box Sign is now available for Free, Personal Pro, and Starter plans.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-08-26

Box Java SDK v3.5.0 released

New Features and Enhancements

  • Add content-type sign request and response (#1087) (49411aa)
  • Add notification_email to BoxUser (#1088) (5477223)
  • Add redirect_url and declined_redirect_url to sign request response (#1089) (3921fe1)

Bug Fixes

  • Fixed canceling sign request fails because of empty body (#1085) (32b8e79)
2022-08-24

Updates to Box CLI

The recent additions to Box CLI script library and CLI guides improve automation even further and simplify handling repetitive tasks.

New CLI scripts

The sample scripts library now includes the following scripts for you to use:

Bulk commands guide

The bulk commands guide explains how you can use a single command to perform actions involving multiple items.

Developer Resources

Are you interested in creating applications for the Box App Center or becoming a Box Partner? Check out the Box Partner Resources guides for more information!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-08-24

Box Windows SDK v4.5.0 released

New Features and Enhancements:
  • Add content-type field to sign request (#850) (054d3e1)
  • expose effective_access in BoxSharedLink #843 (d84ddd4)
Bug Fixes:
  • fix null reference exception when it’s not possible to get runtime version from the assembly (#851) (77046fb)
  • replace infinite retries with exponential backoff strategy in file representations (#835) (f2a5713)
2022-08-19

Box iOS SDK v5.3.0 released

New Features and Enhancements

  • add version_number to FileVersion (#853) (ac81667)
  • Add support for async API in FoldersModule (#851) (58b9dde)
  • Add support for file request API (#867) (ec7813e)
  • Add support for upload and delete Avatar API (#863) (1e967f5)
  • Add support of Editable Shared Link (#861) (bc6ea18)
  • Expose send() method public in BoxClient (#843) (23caaca)

Bug Fixes

  • Respect Content-Type coming from custom headers (#841) (a7c69a7)
2022-08-11

Box Java SDK v3.4.0 released

New Features and Enhancements

  • Added pagination for getting items in trash with new BoxTrash#items API (#1072) (9cd411d)

Bug Fixes

  • buffered body write and fixed SDK logging (#1079) (bc35ef3)
2022-08-09

Box Node SDK v2.5.0 released

New Features and Enhancements

  • Added support update and remove user avatar (#744) (aaf6175)

Bug Fixes

2022-07-29

Box CLI v3.3.2 released

Bug Fixes

  • Fix request command when calling without body (#369) (9317888)
2022-07-25

Box CLI v3.3.1 released

Bug Fixes

2022-07-23

Retention policy API improvements

Recent changes to the API for retention policies and retention policy assignments allow you to remove retention policy assignments and specify the retention length and type for your policies.

Updates

  • Use the new DELETE endpoint to remove an existing retention policy assignment:
curl -i -X DELETE -L https://api.box.net/2.0/retention_policy_assignments/123456/
    -H 'Authorization: Bearer <ACCESS_TOKEN>' 
  • Specify the following parameters when creating or updating retention policies:
    • retention_length: Specifies the duration in days that the retention policy will be active for after being assigned to content.
    • retention_type: Specifies if the policy is modifiable or non-modifiable. This means you can either modify the retention policy in full or in a limited way depending on the need to comply with specific regulatory requirements.

Developer Resources

Are you interested in creating applications for the Box App Center or becoming a Box Partner? Check out the Box Partner Resources guides for more information!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-07-19

Box CLI v3.3.0 released

New Features and Enhancements

  • add editable shared link support (#350) (ab639e7)
  • add file requests API support (#355) (73f0490)
  • add possibility to set custom analytics header (#348) (5a3387f)
  • support —copy-instance-on-item-copy flag for update metadata template (#357) (5d8272a)
  • support Client Credentials Grant as authentication method (#335) (4649d8a)
2022-07-13

Box Node SDK v2.4.0 released

New Features and Enhancements

  • Added support for file requests (#742) (30b2e76)
  • Added support of admin_logs_streaming stream type (#740) (406950a)

Bug Fixes

  • properly handle client errors in streams (#736) (12378d6)
2021-06-24

New Box Sign webhook triggers

The Webhook Event Triggers now include the following Box Sign events you can use to trigger a version 2 webhook:
  • SIGN_REQUEST.COMPLETED
  • SIGN_REQUEST.DECLINED
  • SIGN_REQUEST.EXPIRED
For details on creating webhooks read this guide.

Developer Resources

Are you interested in creating applications for the Box App Center or becoming a Box Partner? Check out the Box Partner Resources guides for more information!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-07-06

Updated Cross-Origin Resource Sharing (CORS) documentation

We updated the documentation on Cross-Origin Resource Sharing (CORS).

Updates

Added information on what to do in case of the Access-Control-Allow-Origin header issues.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum.
2022-07-06

Box Python SDK v3.4.0 released

New Features and Enhancements

  • Add support for editable shared links for files (#737) (1396200)
  • Support uploading and deleting user avatar (#743) (fe00a9e)
2022-07-04

Box Java SDK v3.3.0 released

New Features and Enhancements

Bug Fixes

  • Fix closed stream exception in canUpload method (#1067) (543f91c)
2021-06-30

Improvements in Web App Integrations documentation

We updated documentation on creating Web App Integrations with Custom Apps to reflect all the information from the developer console.

Updates

  • Added description of all elements in the App Info section.
  • Expanded the Callback Parameters section with information about parameter syntax.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum.
2022-06-30

Box CLI v3.2.0 released

New Features and Enhancements

  • Added support for stream type admin_logs_streaming (#337) (7596157)

Bug Fixes

2021-06-24

Box Sign API supports setting redirect URLs

The Box Sign API now offers new parameters to set up custom redirect URLs for users who sign or decline a sign request. This way, when integrating your application with Box Sign, you can redirect the signers back to your application or display a custom landing page.

Updates

Box Sign API provides optional parameters to pass in the request body of the Create Sign Request call:
  • redirect_url that redirects the user to a specific page after signing a request
  • declined_redirect_url that redirects the user to a specific page after declining a request
You can define redirect URLs globally for all signers and for specific signers only. For details, see the Create Sign Request guide.

Developer Resources

Are you interested in creating applications for the Box App Center or becoming a Box Partner? Check out the Box Partner Resources guides for more information!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-06-24

Automate tasks with Box CLI and scripts library

The Box CLI now features a sample scripts library with templates you can use to automate your tasks. For starters, we wanted to provide you with a PowerShell script that allows you to:
  • set up a folder structure,
  • create managed users,
  • add the users to the folder structure as collaborators.

Updates

  • The Box CLI quick start guide now provides instructions on using a PowerShell script to create a folder structure and collaborators.
  • The scripts library is where you can find all sample scripts. Currently, it includes the PowerShell script but more samples are on the way!

Developer Resources

Are you interested in creating applications for the Box App Center or becoming a Box Partner? Check out the Box Partner Resources guides for more information!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-06-17

Box CLI v3.1.0 released

New Features and Enhancements

  • Add —all flag for search to return all results (#336) (23ea0a5)
  • add unique state parameter to OAuth2 login (#292) (5ce6a40)
  • allow changing base URLs (#303) (e284059)
  • obtain oauth authorization from command line (#299) (18c88bb)
  • use native credential storage for MacOS and Windows (#295) (74c4922)

Bug Fixes

  • users:transfer-content to respect quiet flag (#288) (1d0bbab)
  • correctly pass copy-instance-on-item-copy flag (#285) (cd4fbf4)
  • Fix updating webhook triggers (#297) (09e94c3)
  • support large output when using json flag by replacing json.stringify (#328) (1204f2c)
  • Support limit flag for Box Search (#323) (0009a77), closes #322
  • Support OAuth with multiple redirect URIs (#302) (9fe216e)
2022-06-14

Box Windows SDK v4.4.0 released

New Features and Enhancements:
  • add can_edit field to SharedLink (#831) (e0d4197)
  • add version_number to BoxFileVersion (#820) (f174358)
  • add upload and delete support for Avatar API (#829) (4dcb84a)
Bug Fixes:
  • Fix initialization of BoxAPIException object (#828) (a298f01)
  • properly dispose response on exception (#819) (8415bd3)
2022-06-11

Box Java SDK v3.2.1 released

Bug Fixes

2021-05-24
You can now visit the completely updated Box App Center to find the over 1500+ integrations you already know and love.

Updates

Box App Center provides a modernized catalog of apps and integrations and will be accessible from the Box Web app.For end-users, the Box App Center makes it smoother to work the way you want to, thanks to the comprehensive selection of ready-to-use integrations from partners such as Microsoft, Zoom, Salesforce, and Slack, to name a few.For IT leaders and admins, the Box App Center gives your users choice, without sacrificing security or user experience. And it eliminates shadow IT by providing a list of enterprise-approved options.Box App Center will be part of the Core Box package; The Box App Center is available to all customers today!

Developer Resources

Are you interested in creating applications for the Box App Center or becoming a Box Partner? Check out the Box Partner Resources guides for more information!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-05-24

Box Java SDK v3.2.0 released

New Features and Enhancements

2022-05-18

OAuth 2.0 Redirect URL Strict Checking Enabled

Today, we turned on strict checking for all OAuth 2.0 applications.On November 29, 2021, we announced new applications using OAuth 2.0 will require the URIs set in the configuration tab of the Developer Console to strictly match the one used during redirect.This change has now been completed. If your enterprise had applications that were not following this standard, you should have received four emails over the past few months describing how to update your applications.

How to solve redirect errors

If you did not receive the email or missed the communication, below you will find the steps to mitigate any issues.
  1. You can change the redirect URL in the Box Developer Console configuration tab for your application. If the URLs are static, then you can update the Developer console to add multiple URLs. If the URLs are dynamic, then update your application to use a static URL or use the state parameter.
  2. You can change the redirect URL used in your application code to strictly match the URL in the developer console.
For option #1, please use these steps:
  • Login to Box as the application owner and navigate to the Box Developer Console
  • Click on the application and navigate to the configuration tab
  • Scroll down to the “OAuth 2.0 Redirect URI” section
  • Update the current URL listed
For option #2, please modify your application code to replace the impacted used URLs to strictly match the URL in the Developer Console.

Updates

  • Redirect URIs now force strict checking to match the URI passed in and URIs configured in the OAuth 2.0 application configuration

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum or file a ticket with Box Support.
2022-05-18

New Endpoints to Manage User Avatars

Starting today, the User Avatar APIs supports adding, updating, and deleting user avatars.To create or update a user avatar, call the POST /users-id-avatar endpoint. Remember to include the path to the file you want to upload. If an avatar already exists, it will be replaced with the new photo uploaded.
curl -i -X POST -L https://api.box.net/2.0/users/userID/avatar 
    -H 'Authorization: Bearer <ACCESS_TOKEN>' 
    --form 'pic=@"path/to/file/file.jpeg"'
The response includes the user avatar object with URLs to the file location.To delete a user avatar, call the DELETE /users-id-avatar endpoint:
curl -i -X DELETE -L https://api.box.net/2.0/users/userID/avatar 
    -H 'Authorization: Bearer <ACCESS_TOKEN>'

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-05-16

Box UI Elements v15.0.0 released

15.0.0 (2022-05-16)

Bug Fixes & Features

This release fixes several bugs and adds new features. For a full list of changes, please see the release notes.
2022-05-12

New Field Added to Sign Requests

Box Sign request response objects now include a new field - content_type. This field identifies the type of content expected for the type of input selected for the signer to complete.

Updates

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum.
2022-05-11

New Fields Added to Event Specification

The Event resource specification now includes two new fields:
  • created_at specifying when an event was created
  • recorded_at specifying when an event was registered in the database

Updates

  • Added new fields created_at and recorded_at to the [Event] resource specification 2.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-05-06

New Field Added to Sign Events Payload

The additional_details Sign Events payload now includes the batch_send field identifying a sign request sent to multiple recipients at once. If such a batch send request exists, the payload also provides its id.

Updates

  • Added new field batch_send to additional_details payload for Sign Events.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-05-06
Now, developers can make files editable via shared links using the API.

Documentation Updates

Enhancement Details

  • Instead of having to collaborate a user into a file to give edit access, you can set the shared_link.permissions.can_edit field to true.
  • The can_edit field will be returned for all shared link objects on files, folders, and web links; however, you can only set it to true for a file.
  • Our SDK libraries will gain this feature in the coming quarters.
  • If an admin has turned off editable shared links in the admin console, you will not be able to use this feature.

cURL Example

curl -i -X PUT 'https://api.box.com/2.0/files/123456789?fields=shared_link' \
        -H 'Content-Type: application/json' \
        -H 'Authorization: Bearer [ACCESS TOKEN]' \
        -d '{
          "shared_link": {
            "permissions": {
              "can_preview": true,
              "can_download": true,
              "can_edit": true
            }
          }
        }'

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-04-28

Box Python SDK v3.3.0 released

New Features and Enhancements

  • Add support for multiple date time formats (#722) (92364de)

Bug Fixes

2022-04-28

Box Node SDK v2.3.0 released

New Features and Enhancements

  • Add description parameter to uploadFile methods (#730) (2596584)

Bug Fixes

  • added missing js-docs on shared links (#731) (3554d41)
2022-04-22

Box iOS SDK v5.2.1 released

Bug Fixes

  • Expose fields from BoxResponse for custom API calls (#833) (bae1536)
2022-04-21

Improvements In Platform Apps Approval Flow

Today we added further improvements to the platform apps approval flow. As a result, you can now use a new Enablement tab in Developer Console to directly request a Box Admin to enable OAuth 2.0 platform apps.Additionally, Box Admins can use Platform Apps Manager to view and enable platform apps in Admin Console.

Updates

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-04-20

Box Node SDK v2.2.0 released

New Features and Enhancements

2022-04-19

Box Windows SDK v4.3.1 released

Bug Fixes:
2022-04-06

Notice of behavior change for collaboration events on the changes stream

Starting today, we will begin rolling out changes to the behavior of collaboration events when an application consumes those events from our event API endpoints.This change will only affect COLLAB_INVITE_COLLABORATOR, COLLAB_ADD_COLLABORATOR, COLLAB_ROLE_CHANGE, and COLLAB_REMOVE_COLLABORATOR user events with the query parameter stream_type set to changes. This will not affect existing enterprise events. The new behavior will not cause downtime within existing applications or require any application changes to prevent uptime disruptions.

Change overview

Previously, events of type COLLAB_INVITE_COLLABORATOR, COLLAB_ADD_COLLABORATOR, COLLAB_ROLE_CHANGE, and COLLAB_REMOVE_COLLABORATOR created notifications for the acted upon users that were listening to the changes stream. Owners of the collaborated item would not receive these events unless they were listening to the all stream as well.We are cleaning up this discrepancy by establishing parity between the all and changes stream. With this new behavior, notifications of a collaboration will be created for the content owner on the changes stream as well. Collaboration owners will now see an additional event that matches what they see on the all stream.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-04-01

Box Windows SDK v4.3.0 released

New Features and Enhancements:
  • add SourceLink support for Core project (#795) (a9cbede)
Bug Fixes:
  • add missing enum to string parsing in several places (#813) (e370282)
  • properly cast response when uploading a new file version using session (#810) (73d877f)
2022-03-28

Box Node SDK v2.1.0 released

New Features and Enhancements

  • Client Credentials Grant authentication method (#709) (fbf4e80)
  • Deprecating index_name when executing metadata query (#686) (e01cc65)
  • test: add support for testing with Jest (#676) (1a11759)

Bug Fixes

  • Client Credentials Grant authentication method supports token down-scoping (#710) (730368f)
  • Fix JWT expiration field being float instead of integer (#715) (7e950f1), closes #713
2021-03-24

New Search API Query Parameter

Now, you can filter searching for content in the API using the new field recent_updater_user_ids.

Updates

  • Added new query parameter recent_updater_user_ids to the GET /get-search API endpoint

Features

  • Limits the search results to any items that have been updated by the given list of users, defined as a list of comma separated user IDs.
  • This feature only searches back to the last 10 versions of an item.

cURL Example

curl -i -X GET "https://api.box.com/2.0/search?query=sales&recent_updater_user_ids=1234567890,2314567890" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-03-22

Box Java SDK v3.1.2 released

Bug Fixes

  • Allow using As-User header with CCG Authentication (#1031) (b0c2389)
  • Fix retry logic when Retry-After header is present (#1033) (05224c4)
2022-03-18

Box iOS SDK v5.2.0 released

New Features and Enhancements

  • Add disposition_at field to the File object (#814) (3c90df0)
  • Add support for Client Credentials Grant authentication method (#821) (f6d7542)
2022-03-17

New Box CLI YouTube Video

Back in February, we launched the OAuth 2.0 version of the Box CLI, alongside new YouTube content. Today, we released video 2 of the series. It shows using the built in help functionality to create a folder with the CLI.You can find the Box Platform and Developer Playlist on YouTube. We have two more videos planned: Advanced Topics (including as-user) and CLI Automation using PowerShell.Make sure to subscribe to the Box Channel to get all the latest content!

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-03-16

Announcing SDK Supported Versions

Starting July 30 2022, only the current major version of a SDK will be supported. New features, functionality, bug fixes, and security updates will only be added to the current major version.A current release is on the leading edge of our SDK development, and is intended for customers who are in active development and want the latest and greatest features. Instead of stating a release date for a new feature, we set a fixed minor or patch release cadence of maximum 2-3 months (while we may release more often). At the same time, there is no schedule for major or breaking release. Instead, we will communicate one quarter in advance the upcoming breaking change to allow customers to plan for the upgrade. We always recommend that all users run the latest available minor release for whatever major version is in use. We highly recommend upgrading to the latest SDK major release at the earliest convenient time and before the EOL date.We use a modified version of Semantic Versioning for all changes. See version strategy for details.

Supported version for each SDK

Below find links to the charts of supported versions for all SDKs.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-03-11

Box Python SDK v3.2.0 released

New Features and Enhancements

  • Add setting disposition_at field for files under retention (#710) (91b1373)
  • Add support for Client Credentials Grant authentication method (#705) (d33d16d)

Bug Fixes

2022-03-03

Developer Documentation Updates

Today, we released several updates and bug fixes to our developer documentation. Click below to find out more information!

Updates

  • Added additional trailing backslashes for metadata query examples
  • Removed extra quotes from metadata query examples
  • Updated and added examples for Shield Smart Access events
  • Added note to the can_view_path field
  • Corrected trash resources to represent the right responses returned by the API
  • Added an iOS filter to the changelog
  • Added note to folder lock endpoint
  • Added note to developer token guide that says revoking token removes webhook
  • Removed the 94x94 option from the thumbnail endpoint
  • Added note to the events limit parameter
  • Added note to the user login parameter
  • Added app users to the PUT user endpoint
  • Added external_app_user_id field to the PUT user endpoint
  • Changed all references throughout documentation of X-REF-HINTS to x-rep-hints
  • Added new fields to all 11 Box Sign events

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-02-28

Box Java SDK v3.1.1 released

Bug Fixes

2022-02-18

Box Java SDK v3.1.0 released

New Features and Enhancements

  • Added support for Client Credentials Grant authentication method (#1002) (9cfcaff)
  • API to extend disposition date on a file (#1001) (f3f6b60)
  • Deprecating indexName when executing metadata query (#1000) (c20dbbf)

Dependency Upgrades

2022-02-10

Client Credentials support in the SDKs

Our .NET and Java SDKs now support Client Credentials Grant authentication. We plan to release the support for the other SDKs in the coming weeks.Back in November 2020, we released a new authentication type for custom applications called Client Credentials. Today, we have started releasing SDK support for the new type.

Updates

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-02-16

Box Python SDK v3.1.0 released

New Features and Enhancements

  • Add support for Python 3.10 (#692) (d4aed82)
  • Add support for Python 3.8, Python 3.9, pypy-3.7 and pypy-3.8. (#689) (0aa94cc)
  • Deprecate use_index parameter from MDQ of files/folders (#666) (2595720)
  • Replace external package mock with Python standard library unittest.mock (#697) (6fd6366)
  • Upgrade cryptography library to the most recent version. (#668) (9c94d08), closes #667

Bug Fixes

  • UploadSession.commit returns None when retry limit was reached (#696) (9456fe0)
  • Add missing api_call decorator for create_upload_session (#686) (3510d3a)
  • Fix chunked upload (#673) (2605fd7), closes #671
2022-01-25

New Box Shield Access Policy Monitoring Mode

Recently, Box Shield added a new feature that allows admins to test out Access Policies with a new monitoring mode.

Updates

  • Added the new controlMode field to all events in the Smart Access events section
  • Added application and FTP restriction information in the Smart Access events section

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-02-10

Box Windows SDK v4.2.0 released

Bug Fixes:
  • correctly pass null when rolling out user from the enterprise (#792) (c85c573)
  • Creating BoxAuthenticationFailedException no longer throws an exception (#790) (55a706e)
  • Null Argument Exception in AutoPaginate (#666) (c61f08c)
New Features and Enhancements:
  • add admin_logs_streaming support (#797) (a775e1e)
  • add Client Credentials Grant auth support (#799) (b8a64ca)
  • add disposition_at field to the File object (#793) (2766a91)
  • add possibility to set auth token uri in BoxConfig (#794) (ae8cd8b)
  • deprecate index_name in ExecuteMetadataQuery (#800) (6a6a0e4)
2021-12-31

EOL Notification For DICOM

Box has retired (End of Life/EOL) our DICOM Uploader and turned off native previewing of boxdicom studies as of December 31, 2021.The developer documentation for DICOM has now been removed. For more information, please see the product announcement for alternatives.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2022-02-01

Box CLI v3.0.0 released

Today, we released v3.0.0 of the Box CLI. This release has several enhancements, most notably - addition of OAuth 2.0 support.In addition to CLI enhancements and documentation changes, we also released a brand new YouTube video that shows using our Box CLI Quick Start to get started with the CLI in less than five minutes!

Developer Documentation Changes

New Features and Enhancements

  • Add support for login with OAuth (#240)
  • feat: support as-user flag for bulk files and when token is present (#270)
  • Add support for copyInstanceOnItemCopy field for metadata templates (#239)
  • Add support note to the mdfilter equality check in search (#253)
  • Add support for Box Sign API (#258)
  • Add support Metadata Query API (#259)
  • fix: folder:collaborations:add make role a required flag (SDK-1070) (#261)
  • Minor dependencies upgrade
  • Add new API for files and file versions under retention (#250)
  • Adding support for sign request (#258)
  • Support Metadata Query API (#259)
  • chore: enforce conventional commits (#268)
  • feat: support as-user flag for bulk files and when token is present (#270)

Breaking Changes

  • Drop support for Node 10
  • Insensitive language changes (#247, #252)

Bug Fixes

  • fix: folder:collaborations:add make role a required flag (#261)
  • fix: Fixed shared-links delete example. (#262)

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed. You can also connect with the SDK team on the respective GitHub repository.
2022-01-26

Box Python SDK v3.0.1 released

Bug Fixes:
  • Move sphinx to test requirements (#662)
2022-01-17

Box Python SDK v3.0.0 released

Breaking Changes
  • Drop support for python 2.7 (#645)
  • Add missing parameter stream_position to get_admin_events method (#648)
  • Drop support for python 3.5 (#654)
  • Remove deprecated code using insensitive language (#651)
  • Enforcing usage of keyword-only arguments in some functions (#656)
New Features and Enhancements:
  • Remove six library and __future__ imports (#646)
  • Add type hints to method parameters (#650)
Bug Fixes:
  • Add missing api_call decorators on multi-input calls (#653)
  • Added py.typed file for mypy to recognize type hints (#657)
2022-01-17

Box Java SDK v3.0.0 released

⚠ BREAKING CHANGES

  • Changed BoxFileVersion class and removed fileVersion field (#978)
  • Removed deprecated API BoxCollaborationWhitelist replaced with BoxCollaborationAllowlist, BoxCollaborationWhitelistExemptTarget replaced with BoxCollaborationAllowlistExemptTarget (#969)
  • Dropping Java 7 support (#962)
  • Downgrading bouncycastle libraries to 1.57 (#942)

New Features and Enhancements

  • Add typeName to BoxEvent that contains name of the event, even if it is not mapped to BoxEvent.EventType (#979) (b30f61f), closes #968
  • Add new optional description parameter to the retention_policies endpoint and start_date_field to the retention_policy_assignments endpoint. (#967) (0aa4ff4)
  • Adding BoxFile#getVersions(String... fields) to allow users to specify what information they want to extract. Fixes #946. (#947) (a2eb638)
  • Missing eventTypes from BoxAPI Documents. Fixes #974 (#975) (2c69360)
  • Removed deprecated API BoxCollaborationWhitelist replaced with BoxCollaborationAllowlist, BoxCollaborationWhitelistExemptTarget replaced with BoxCollaborationAllowlistExemptTarget (#969) (2fd4d6f)

Bug Fixes

  • Changed BoxFileVersion class and removed fileVersion field (#978) (8c39451)
  • Changed SDK loggers name to "com.box.sdk", fixes #638 (#950) (443c230)
  • Date parsing error when BoxSignRequestPrefillTag created with date value. (#970) (cc2c8da)
  • Fix sending limit parameter in EventLog (#977) (96bdccc)
  • Fixed NullPointerException when empty metadata used on BoxFile or BoxFolder (#918) (#945) (68bc3c5)
  • Cannot deseralize sign request, fixes issue (#951). (#952) (070bdc5)

Dependency Upgrades

2022-01-17

Box iOS SDK v5.1.0 released

New Features and Enhancements

  • Allow to customize URL for the OAuth2 authorization page (#811) (1901d29)
  • Events: Add support for admin_logs_streaming stream type (#800) (0a3118e)
  • RetentionPolicy: New API for get files and file versions under retention (#807) (38327f0)
  • SharedLink: add support for vanity_name (#799) (3ea6eb2)

Bug Fixes

  • SignRequest: Fix encoding date_value to yyyy-mm-dd format in prefillTag (#806) (4f902a4)
2022-01-06

New Features For Platform App Management

Today, we released changes to the Platform Apps Manager section of the Box Admin Console. Now, you can more easily view and manage enablement of platform OAuth 2.0 Applications.In addition to adding new functionality, we also made updates to the UI of the Platform Apps Manager. For more information on the changes and authorizing apps that use the Box API, check out the blog post.

Updates

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-12-17

End of Support for Obsolete Language Versions

As Box to prepares to release the next major versions of the Python and Java SDKs, this is an alert that support is ending for obsolete language versions.On January 17, 2022, major releases of the Python and Java SDK libraries are planned, ending support for obsolete language versions. The Python SDK will abandon Python 2.7 and Python 3.5 starting from version v3.0.0 of the Python SDK. The Java SDK will abandon Java 7 starting from version v3.0.0 of the Java SDK. Applications using the Python or Java SDK can still use the respective older versions of those libraries located in the GitHub release section, but any future new features will not be available for use.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed. You can also connect with the SDK team on the respective GitHub repository.
2021-12-14

Box Windows SDK v4.1.0 released

Bug Fixes:
  • add missing configureAwait(false) when awaiting to prevent deadlocks (#775) (b16267e)
New Features and Enhancements:
2021-12-08

Box Python SDK v2.14.0 released

New Features and Enhancements:
  • Add admin_logs_streaming support for events stream (#623)
  • Add vanity_name parameter for creating shared link to a file or folder (#637)
  • Add getting files and file versions under retention for a retention policy assignment (#633)
  • Support base item operations for WebLink class (#639)
Bug Fixes:
  • Limit cryptography to version <3.5.0 (#636)
  • Avoid raising 404 when a thumbnail cannot be generated for a file (#642)
2021-11-29

OAuth 2.0 Redirect URL Updates

Today, we released a new feature to the Box Developer Console, allowing developers to add multiple redirect URIs for an OAuth 2.0 application.Starting November 29, 2021, new applications using OAuth 2.0 will require the URIs set in the configuration tab of the Developer Console to strictly match the one used during redirect. In addition, both new and existing applications, will gain the ability to add multiple redirect URIs.For existing applications, the deadline to make changes to this URL and avoid service disruption is May 13, 2022.

Updates

  • The Box Developer Console OAuth 2.0 application configuration section has a new button to add multiple redirect URIs
  • Redirect URIs now force strict checking to match the URI passed in and URIs configured in the OAuth 2.0 application configuration
  • Updated the redirect_uri query parameter wording on the GET /authorize endpoint page
  • Updated the OAuth 2.0 setup, with SDK, and without SDK guide pages

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-11-23

Box Java SDK v2.58.0 released

New Features and Enhancements:
  • SDK support for new GET /events stream_type: admin_logs_streaming (#938)
  • Adding BoxDeveloperEditionAPIConnection#getUserConnection to indicate that we can use this connection for managed users or app users (#940)
Bug Fixes:
  • Fix for deprecated enums still being used (#931)
2021-11-22

New Shield Download Event

Today, we released a new event_type to the Enterprise Event stream for downloads that are restricted based on a Shield access policy.If an admin creates a shield access policy that restricts downloads and an end user is blocked from downloading a file, an event is produced within the enterprise event stream. Events will also be generated when a user is viewing a folder with a file restricted from download, viewing a file in preview that is restricted from download, and when a user requests to download a file through the API that is restricted from download. These events follow the standard event object schema and the event_type value set to SHIELD_DOWNLOAD_BLOCKED.

Updates

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-11-17

New Event Stream Live Monitoring stream_type

Today, we released a new stream_type for the GET /events API called admin_logs_streaming. This allows for near real time monitoring of events after they happen in Box.We recommend that applications subscribing to live events through admin_logs migrate to admin_logs_streaming for the lowest and most consistent latency. This stream_type requires the user to be an enterprise admin or co-admin with the permission to Run new reports and access existing reports.

Updates

We have made several documentation updates to help you learn about the new option
  • Completely reorganized the events guide section for easier understanding, including adding additional information to all pages in the various sections
  • Updated the OpenAPI specification for the GET /events endpoint to include the new stream_type option of admin_logs_streaming
  • Added a new how to migrate stream_type page with steps on switching

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-11-16

Added Retention Policy Marker Based Pagination

Our OpenAPI specification has been updated for retention policy and retention policy assignment endpoints to show use of marker based pagination and fields query parameters.

Updates

The following updates were made:

Where to get support

Should you have any issues or need further guidance, please create a post on our developer forum for any help needed.
2021-11-03

Extend Retention Via Files API

Now, you can extend the retention date for a file that is already under retention using the new disposition_at field. If the date is extended, it cannot be reverted or updated to a date prior to the new date.

Updates

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-11-02

Box Windows SDK v4.0.0 released

Breaking changes:
  • Extract interfaces for BoxClient and Managers to improve testability (#603)
  • Add BoxConfigBuilder and make BoxConfig immutable (#737)
  • Expose tasks from async methods (#742)
  • Use DateTimeOffset instead of DateTime (#749)
  • Rework returned exceptions (#753)
  • Upgrade .NET Standard to 2.0 (#755)
New Features and Enhancements:
  • Add ability to get files under retention for assignment and file versions under retention for assignment (#734)
  • Add is_collaboration_restricted_to_enterprise flag support for Folder update (#732)
  • Replace insensitive language (#738)
  • Add new, easier to use method for create terms of service user status (#740)
  • Allow sort and direction parameter to be passed in when getting trashed items (#754)
  • Add support for Task completion_rule field (#758)
  • Add BoxSign API support (#765)
Bug Fixes:
  • Fix Cannot access a closed Stream.Request exception during upload (#739) (#757)
2021-10-28

Box iOS SDK v5.0.0 released

Breaking Changes:
  • Update PagingIterator to return pages and simplify logic (#737)
  • Remove insensitive language field collaborationWhiteList in BoxClient. Use collaborationAllowList instead. (#790)
New Features and Enhancements:
  • Replace insensitive event types (#785)
  • Add SignAPI support (#792)
2021-10-27

Box Sign Enterprise Events

Box Sign events are now available via the enterprise events stream. For full details, please see our Box Sign events guide.

Updates

  • Add sign request document events: created, converted, completed, cancelled and expired
  • Add sign request signer events: assigned, viewed by signer, downloaded, forwarded, signed and declined
  • Add two new statuses: downloaded and downloaded and signed
2021-10-20

Box UI Elements v14.0.0 released

14.0.0 (2021-10-20)

Bug Fixes & Features

This release fixes several bugs. For a full list, please see the release notes
2021-10-20

App Diagnostics Report Feedback

We recently started releasing the new App Diagnostics Report to customers, and we would love to hear your thoughts! Visit the forum post to provide any feedback.
2021-10-18

Box Java SDK v2.57.0 released

New Features and Enhancements:
  • Add support for marker-based paging in BoxFolder.getChildren (#927)
  • Upgraded minimal-json to version 0.9.5
  • Upgraded jose4j to version 0.7.9
  • Adding Gradle wrapper in version 4.0.1 (#928)
Bug Fixes:
  • Fix for infinite recursion (#924)
  • Fix unable to set Vanity URL on BoxSharedLink for BoxFile and BoxFolder (#925)
2021-10-07

Update to Webhooks Response

The webhook response has been updated to show the correct Webhook (Mini) object in the entries array.

Bug Fixes

2021-10-07

New App Diagnostics Report

A new report will be gradually deployed to customers starting Thursday, October 7th, 2021. We plan to have the report released to all customers by October 25th.Developers can now review API activity for their applications by generating an App Diagnostics Report from the Developer Console. Checkout the guide to see the steps required to run a report!As always, if you have issues you may file a support ticket or post on our developer forum.
2021-10-06

Support for Adobe Creative Cloud Previews

In conjunction with WebApp preview, Adobe Photoshop, Illustrator, and InDesign files are now supported via API.

Updates

Files with extensions indt, idml, indd, and inx are supported by:
2021-09-30

Box Python SDK v2.13.0 released

New Features and Enhancements:
  • Sensitive language replacement (#609)
  • Add BoxSign support (#617)
Bug Fixes:
  • Upgrade cryptography to version 3 (#620)
2021-09-29

Box Node SDK v2.0.0 released

Breaking changes:
  • Drop support for Node 6,7 (#670)
New Features and Enhancements:
  • Add support for is_external_collab_restricted User property (#668)
  • Bump proxy-agent from 4.0.0 to 5.0.0 (#664)
2021-12-21

EOS for Open With UI Element and EOL for Adobe Sign

Today, the Open With UI element can integrate with Box Tools, Google Workspace, and Adobe Sign. In an effort to continuously improve the Box experience, we are focusing our resources on new features and functionality that better align with our users’ evolving needs.December 21, 2021 the following changes will occur:
  • We will discontinue support of the Box Open With UI Element for Box Tools and Google Workspace for any new customers. A new customer is any customer not using this element prior to December 21. Any customers leveraging the Open With UI Element with Box Tools and/or Google Workspace prior to December 21 are considered existing customers and will continue to receive support until further notice. The Box Tools and Google Workspace Web App functionality will not be impacted.
  • Adobe Sign will no longer be available for use by new or existing customers via the Open With UI element or Web Application.
Should you have any further questions, please contact us by opening a support ticket or posting on the developer forum.
2021-09-07

New enhancements to retention APIs

Two new API endpoints have been introduced to get files and file versions that are under retention for a given retention policy assignment. These APIs are part of the retention policy suite of APIs. They are intended to replace the separate file and file version retention endpoints, which will soon be deprecated from the Box API. The date of the deprecation will be announced at a later date.When a retention policy is applied via a retention policy assignment, folders are selected for which the retention policy should be applied. The files and file versions within those folders will be the content that is returned from calling these new endpoints.

Features

This release has introduced the following new content and features.
  • Get files under retention: Returns a list of files under retention that are associated with the specified retention policy assignment.
  • Get file versions under retention: Returns a list of file versions under retention that are associated with the specified retention policy assignment.
  • Added an editable description field to the retention policy resource.
  • Added a non-writable start_field_date to the retention policy assignment resource. This field is the metadata field’s key id. The value can also be upload_date if the assigned_to type is not metadata_template or a date field has not been selected.
2021-09-01

Classification Name Field now in Events API

If a classification exists on content, the events API now returns the classification name field in the response object.
  • The updates to the event source response object can be seen here.
  • A new guide page has been added to show examples for an event triggered by a user source and an event source.
Below is an example of the response before and after the enhancement. Please note that if a classification doesn’t exist, the before example will still be returned.Before:
{
  "source": {
    "item_type": "file",
    "item_id": "8903212345",
    "item_name": "example.docx",
    "parent": {
      "type": "folder",
      "name": "All Files",
      "id": "0"
    },
    "owned_by": {
      "type": "user",
      "id": "11446498",
      "name": "Aaron Levie",
      "login": "notifications@example.com"
    }
  }
}
After:
{
  "source": {
    "item_type": "file",
    "item_id": "8903212345",
    "item_name": "example.docx",
    "parent": {
      "type": "folder",
      "name": "All Files",
      "id": "0"
    },
    "owned_by": {
      "type": "user",
      "id": "11446498",
      "name": "Aaron Levie",
      "login": "notifications@example.com"
    },
    "classification": {
      "name": "Top Secret"
    }
  }
}

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-08-31

Notice of behavior change for item preview events

Starting today, we will begin rolling out changes to the behavior of item preview events when an application consumes those events from our event API endpoints.This change will only affect the ITEM_PREVIEW user event and will not affect existing enterprise events. The new behavior will not cause downtime within existing applications or require any application changes to prevent uptime disruptions.

Change overview

Within the previous behavior when events were consumed, previewed item events were surfaced through the ITEM_PREVIEW event type for the owner of the content as well as any contributors assigned to the content. This meant that if a file with 2000 collaborators on it was previewed, the file owner plus all 2000 collaborators would have an event created stating that the file was previewed.With the new behavior, notification of an item being previewed will only be created for the owner of the content and will not be produced for collaborators. This will help to reduce the noise of the event stream while preserving the ability to see when items are previewed as a content owner.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-08-31

Box Java SDK v2.56.0 released

New Features and Enhancements:
  • Replace submaster GroupMembershipRole with coadmin. Replace MASTER_INVITE_ACCEPT and MASTER_INVITE_REJECT with ADMIN_INVITE_ACCEPT and ADMIN_INVITE_REJECT. (#907)
  • Add tracking_codes to create User API call (#910)
Bug Fixes:
  • Fix url for BoxFileRequest.Info object (#906)
  • Attempt to fix thread locking issue on refresh of access token (#912)
2021-08-30

Box Node SDK v1.39.0 released

New Features and Enhancements:
  • Add support for Box Sign API (#658)
  • Enhance TS Imports (#656)
2021-08-06

Box Node SDK v1.38.0 released

New Features and Enhancements:
  • Add sensitive language event types for admin invites (#648)
  • Use BetterDocs to adapt JSDocs to TypeScript (#646)
  • Change ProxyAgent import to be dynamic (#641)
  • New API for get files and file versions under retention (#585)
Bug Fixes:
  • Deeply freeze Config except Buffers and Readable streams (#651)
  • Fix a typo in docs of src/managers/search.ts (#649)
  • Update broken documentation link (#647)
  • fix type annotations for exchangeToken functions (#645)
  • Deprecate files getThumbnail API in favor of getRepresentationContent (#627)
2021-06-04

Upcoming change to JWT format

On August 4th, 2021, as part of our continued infrastructure upgrades, we will begin deployment of a change that may affect custom applications leveraging Server Authentication with JSON Web Tokens (JWT).Potential impact will require additional verification from customers who do not use an official Box SDK and are storing tokens in a database.All customers and application owners who are potentially impacted have been notified directly via email.

Change overview

This change may only impact applications leveraging Server Authentication with JSON Web Tokens (JWT). Tokens will continue to return as a string as stated in our documentation. However, the format will be longer and containspecial characters.An example of a token returned today: NXWd9KDPVofXQKZJlQjICCWFHEmuOihs.After this change, tokens will return in the following format:1!yxxhRreQCKcEbC_ZfYvPudyLe7Ed36gIQcqqZo2pfaVZyxNBkQjoHk0fgA1iTY3_uwXgif-hg-gne aUdLRmGCb2He6tyQ_rA8aV-CllTyBbd9Tx-wU6Fnt4Df9XjzBAk8Dj7RYc1Ew_fcY2vfycpCvjwHLgql jzjEpVIrOpOlK_2AyP5FExzn0x7DtbkaGc6avJU8UMQd_huXoJ7CnXIL_JBzVrW4D32pBLQ2AZIuecOZ NMIy9T8PdUiZIG6xKEPqYmm21mQHEM0d7dT5foSBtjm65-Ah2tb2MdSGFb1G1O24vz2GmYFgmIe5UOol qYIGg-0u2xQPC3F76WiNCiU_TP1JDQYi3HKaos807WkRtnBY5Vd-VAbY9DH-Qo3u1EiB0RFr4cht2N7V B99y-379IEYzCojL2V58dE_pBxpRMv4KcOLVsUfDkbx3uo34H4UzOycI_IWGWrhVJD4M7GeLeD_5Vkmj fbwYl2CmHdXAKbZKtXTHjzB0CZixZriT_wRUpsN8GTrrxGbx9ukgzJWRJwelGZ_1Yx7vP4Zkx3OfR5Be -Tso7xdHd9rW0FXsu024U7dMNuQ6kpP1_kJI2Y.Please note that this is not a new format to Box, as this format is currently returned when downscoping tokens.

Verifying application impact

  1. Navigate to Admin Console > Apps Tab > Custom Apps.
  2. Click View for each app row listed
  3. Scroll to the bottom of the app details page and verify the selected authentication method. Affected apps will say Server Authentication with JSON Web Tokens.
For each application identified above, you will need to determine:
  1. Is it using an official Box SDK? If so, no further action is required to prepare for this change. While it is always best practice to be on the latest version, no minimum versions are required for compatibility.
  1. If an official SDK is not used, are tokens stored in a database? If so, you will need to preform additional verification that the database can handle both the new length and special characters.

Testing before release

If you have identified an application that leverages Server Authentication with JWT and stores tokens in a database, you will want to preform the test below before August 4th.As mentioned above, the new format for tokens is currently used when downscoping tokens. Therefore, preform the following steps to assess impact:
  1. Generate an Access Token for the application
  1. Downscope the token from step 1
  1. Attempt to store the downscoped token in your database
If you are successfully able to store the token in the database no further action is necessary to prepare for this change.If you are unable to store the token, your database must be updated to support the additional length and special characters.

Where to get support

Should you have any questions or need further guidance, please email jwt-set-rollout@box.com.
2021-07-26

New Getting Started Guide

Check out our step by step guide to getting started with the Box API. Discover best use cases, user models, architecture patterns, and more.

Features

  • Use case evaluation: Guide
  • Common user models: Guide
  • Common architecture patterns: Guide
  • Locating common values: Guide
  • Security overview: Guide
  • Authentication best practices: Guide
  • Detailed authorization steps: Guide
2021-07-30

Box Java SDK v2.55.1 released

Bug Fixes:
  • Restore methods for Execute Metadata Query, which were removed in #890, and mark them as deprecated (#905)
2021-07-26

Release of Box Sign API

Today, July 26th, 2021, beings the roll out of Box Sign! Programmatically harness the full functionality of the Box Sign web app experience by leveraging our newest API endpoints to create, list, resend, and cancel Box Sign requests.While Box Sign does not need to be enabled by an Admin to use its API endpoints, it does need to be rolled out to your enterprise. We will notify Admins as it becomes available for their Box instance.At a minimum, creating a Box Sign request requires selecting a file for signature, a destination folder for the signed document/signing log, and designating signers. At this time, only one file can be signed per request.
curl -i -X PUT "https://api.box.com/2.0/sign_requests" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -d '{
       "signers": [
          {    
            "role": "signer",
            "email": "example_email@box.com"
          }
        ],
       "source_files": [
          {
            "type": "file",
            "id": "123456789"
          }
       ],
       "parent_folder": 
          {
            "type": "folder",
            "id": "0987654321"
          }
     }'

Features

2021-07-26

Box Java SDK v2.55.0 released

NOTE: Due to the benign nature of the “breaking change” below, we decided NOT to increment the major version for this release. There should be no customer impact due to this change.Breaking Changes:
  • Update execute metadata query to match API response (#890)
    • NOTE: This change removes a method without deprecating it. It was not possible to use the method correctly at all, because the underlying service no longer supported it.
New Features and Enhancements:
  • Remove or deprecate insensitive language ([#889])(https://github.com/box/box-java-sdk/pull/889)
  • Add support for is_external_collab_restricted parameter for User (#896)
  • Add configurable permissions support for GroupMembership (#897)
  • Add SHIELD_JUSTIFICATION_APPROVAL event type (#898)
  • Add ability to get files under retention for assignment and file versions under retention for assignment (#899)
  • Add TASK_UPDATE, FILE_VERSION_RESTORE and ADVANCED_FOLDER_SETTINGS_UPDATE event types (#902)
  • Add Box Sign API support (#904)
Bug Fixes:
  • Add setters for BoxLegalHoldPolicy (#885)
  • Add setters for BoxTaskAssignment (#886)
  • Add setters for Group Membership and Web Links (#887)
  • Add setters for Webhooks (#888)
  • Deprecate BoxFile.getThumbnail in favor of BoxFile.getRepresentationContent (#891)
2021-07-16

Updated file size limits

Today we released our newest business plan, Enterprise Plus, which supports uploads and downloads up to 150GB. In addition, we upgraded file size limits for some of our existing plans, as detailed below. For details on how to confirm the file size limit for your account, please visit our upload guide.

Updates

  • Enterprise: 50 GB
  • Digital Workplace Suite: 50 GB
  • Digital Workplace Global Suite: 50 GB
  • Digital Business Suite: 50 GB
  • Digital Business Global Suite: 50 GB
  • Enterprise Plus: 150 GB
2021-07-16

New Manual Start Workflow Endpoints

Two new API endpoints have been introduced for Box Relay
  • Get workflows configured on a folder
  • Start a manual start flow within a workflow for file(s)
The new endpoints do not allow you to update any information within the workflows. Also, the post endpoint can only start flows with a trigger_type of WORKFLOW_MANUAL_START. There is an optional outcome_parametes object within the post request body. If your flow is configured to accept selections at start time, you will need to send in these as a parameter. A guide with all the options you can send in will be made available soon.

Features

This release has introduced the following new content and features.
  • New workflow resource
  • New GET workflows endpoint
  • New POST start manual workflow endpoint
2021-07-01

Notice of behavior change for item open events

Starting today, we will begin rolling out changes to the behavior of ITEM_OPEN events when an application consumes those events from our event API endpoint.This change will only affect the ITEM_OPEN enterprise event. The new behavior will not cause downtime within existing applications or require any application changes to prevent uptime disruptions.

Change overview

Within the previous behavior when events were consumed, opened item events were surfaced through the ITEM_OPEN event type for the owner of the content as well as any contributors assigned to the content. This meant that if a file with 2000 collaborators on it was opened, say on Drive, the file owner plus all 2000 collaborators would have an event created stating that the file was opened.With the new behavior, notification of an item being opened will only be created for the owner of the content and will not be produced for collaborators. This will help to reduce the noise of the event stream while preserving the ability to see when items are opened as a content owner.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-06-16

Box Python SDK v2.12.1 released

Bug Fixes:
  • Fix bug when thumbnail representations are not found (#597)
2021-05-20

Box Node SDK v1.37.2 released

Bug Fixes:
  • Fix backwards compatibility issue by moving some TypeScript @types as direct dependencies (#630)
2021-05-19

Box Node SDK v1.37.1 released

Bug Fixes:
  • Insensitive language: replace whitelist with allowlist (#625)
2021-04-22

Box UI Elements v13.0.0 released

13.0.0 (2021-04-22)

Bug Fixes & Features

This release fixes several bugs. For a full list, please see the release notes
2021-04-20

Box iOS SDK v4.4.0 released

Breaking Changes:New Features and Enhancements:
  • Add support for search parameter to get shared link items (#756)
  • Add support for folder lock functionality (#759)
  • Add support for copyInstanceOnItemCopy field for metadata templates (#763)
  • Add support for stream upload of new file versions and add support for ‘If-Match’ header when uploading new file versions (#766)
  • Add additional details field for Event model (#770)
Bug Fixes:
  • Pass only a scheme to iOS Authentication APIs (#755)
  • Update listEnterpriseGroups() to use documented parameter for filtering by name (#757)
  • Fix bug for OAuth where the callback is not called if token has been revoked (#762)
2021-04-16

Box Python SDK v2.12.0 released

New Features and Enhancements:
  • Add metadata query functionality (#574)
  • Add folder lock functionality (#581)
  • Add search query support for the include_recent_shared_links field (#582)
  • Update get_groups() to use documented parameter to filter by name (#586)
2021-04-16

Box Node SDK v1.37.0 released

New Features and Enhancements:
  • Add support for copyInstanceOnItemCopy field for metadata templates (#572)
Bug Fixes:
  • Fix webhook signature validation (#568)
  • Update dependencies to patch security vulnerabilities (#578)
2021-04-15

Notice of behavior change for item download events

Starting today, we will begin rolling out changes to the behavior of item download events when an application consumes those events from our event API endpoints.This change will only affect the ITEM_DOWNLOAD user event and will not affect existing enterprise events. The new behavior will not cause downtime within existing applications or require any application changes to prevent uptime disruptions.

Change overview

Within the previous behavior when events were consumed, downloaded item events were surfaced through the ITEM_DOWNLOAD event type for the owner of the content as well as any contributors assigned to the content. This meant that if a file with 2000 collaborators on it was downloaded, the file owner plus all 2000 collaborators would have an event created stating that the file was downloaded.With the new behavior, notification of an item being downloaded will only be created for the owner of the content and will not be produced for collaborators. This will help to reduce the noise of the event stream while preserving the ability to see when items are downloaded as a content owner.

Where to get support

Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
2021-04-13
When requesting an access token, you now have the ability to downscope that token to a file or folder using a shared link.This new parameter may be used instead of using the resource parameter, which allows you to supply a file or folder ID to perform the same action.

Updates

  • Added new box_shared_link request parameter to downscoping documentation. A shared link may be supplied to downscope an access token in the below way.
{
  curl -i -X POST "https://api.box.com/oauth2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "subject_token=[ACCESS_TOKEN]" \
     -d "subject_token_type=urn:ietf:params:oauth:token-type:access_token" \
     -d "scope=item_upload item_preview base_explorer" \
     -d "box_shared_link=https://cloud.box.com/s/123456" \
     -d "grant_type=urn:ietf:params:oauth:grant-type:token-exchange"
}
2021-04-01

Box Java SDK v2.54.0 released

New Features and Enhancements:
  • Add file request support (#869)
Bug Fixes:
  • Fix BoxWeblink deserialization (#881)
2021-03-25

Service Account email added to Developer Console

Upon Admin authorization of an application leveraging server authentication, the auto-generated email address of the Service Account is now surfaced in the General tab of the Developer Console. This email address can then be used to collaborate the user on Box content. The format will always be AutomationUser_AppServiceID_RandomString@boxdevedition.com. For example, AutomationUser_123456_6jCo6Pqwo@boxdevedition.com.To learn more, see our guide on User Types and Service Accounts.

Features

  • Added auto-generated email address of Service Account user to Developer Console
2021-03-25

New Metadata Query Indices Endpoint

A new API endpoint has been introduced to get a list of metadata query indices for a given template and scope.Metadata queries provide a way to find files and folders by searching for the metadata attached to them.When performing metadata queries on 10,000 or more files or folders, non-performant queries may produce an HTTP 403 error. Creating a search index delivers the ability to run these queries at scale to bypass this error state, and are automatically applied during the querying process.The new endpoint permits the lookup of these created search indices.

Features

This release has introduced the following new content and features.
  • New API endpoint to get a list of metadata query indices by scope and template.
  • New metadata query index response object.
  • New metadata query indices response object.

Updates

This release includes the following updated content.
  • Updated metadata query indices guide to include details on how to get a list of metadata query indices.
2021-03-16

New Collection Events

External collection events are now available via the enterprise events stream.Collections in Box are a way to group files, folders, and web links without putting them all into a folder together. These new events provide a method for monitoring when collection actions are taken within an enterprise.The events follow the standard event object schema, and include the following:
  • COLLECTION_CREATE: A collection was created
  • COLLECTION_DELETE: A collection was deleted
  • COLLECTION_UPDATE: A collection was updated
  • COLLECTION_ITEM_CREATE: An item was added to a collection
  • COLLECTION_ITEM_DELETE: An item was removed from a collection
  • COLLECTION_ITEM_UPDATE: An item in a collection was updated
2021-02-26

Box Shield Smart Access events

External collaboration restriction and justification approval events are now available via the enterprise events stream.Box Shield must be purchased and enabled on a Box enterprise in order to take advantage of these advanced security offerings.These events follow the standard event object schema, with the event_type value set of: SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED_MISSING_JUSTIFICATION, SHIELD_EXTERNAL_COLLAB_INVITE_JUSTIFIED, SHIELD_EXTERNAL_COLLAB_INVITE_BLOCKED SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED_MISSING_JUSTIFICATION, SHIELD_EXTERNAL_COLLAB_ACCESS_BLOCKED, or SHIELD_JUSTIFICATION_APPROVAL.The additional_details payload of each event provides more information. Full details can be found in our [Shield Events guide.

Features

  • Add support for Box Shield external collaboration and justification approval events to the enterprise events stream
2021-02-26

Box CLI v2.9.0 released

New Features and Enhancements

  • Add ability to add an option to a metadata template multi select field (#230)
  • Add folder lock functionality (#232)
  • Add support for search parameter to get shared link items (#233)

Bug Fixes

  • Fix events command bug when there is no stream position flag (#234)
  • Fix bug with folders:upload command not uploading folder contents (#231)
2021-05-10

Box API response header changes that may impact your applications

On May 10th, 2021, as part of our continued infrastructure upgrade, Box’s API response headers will standardize to always return in a case-insensitive manner, in line with industry best practices and our API documentation.This change has the following potential impact:
  • Salesforce SDK v1 users will be impacted and will need to upgrade to a recent SDK version. Not doing so will cause your Box Salesforce integration to cease functioning after May 10th, 2021.
  • Box API consumers who do not use one of the Box SDKs may be impacted and will need to verify header usage through their code. Depending on your header usage, not making adjustments may cause disruptions in your Box API integration.
All customers and application admins who are potentially impacted have been notified directly via email.

Change overview

Applications that are using the return headers described above, such as location and retry-after, will need to verify that their applications are checking for these headers in a case-insensitive fashion. Over the past 12 months Box has been upgrading its networking and observability infrastructure. These upgrades aim to improve reliability and availability of Box’s products for our customers. This specific change allows Box to deploy an updated service proxy, enabling Box to better monitor service traffic, quickly find problem areas, and tune application performance.

API Consumers: Verifying application impact

Verifying whether your application(s) will be impacted will require a review of your code. If you are solely using one of the official Box SDKs to connect to Box APIs, you will not be impacted as the SDKs handle response headers in a case-insensitive manner.You may verify whether you are impacted with the following steps:
  • Locate the code in your application which handles the responses from Box API requests. If you are not extracting the response headers from these responses, you are not impacted.
  • If you are extracting those response headers, you may be impacted if you are expecting those headers in a case-sensitive fashion.
For instance, if you are expecting the Location header to be returned with a starting capital L, a direct string comparison with a specific case, then your code will need to be altered to prevent it from breaking after the change is made.

API Consumers: How to make the change

To update the impacted application(s), ensure that you are checking these response headers in a case-insensitive manner. Specifically, your code should be built in a defensive way to ensure that if a header, such as Location, is sent with an initial capital L or a lowercase l, it’ll be handled in the same way. For example, forcing all headers to lowercase before checking, or using a case-insensitive regex string check, are two viable methods for handling this process.

Salesforce SDK v1 users: Verifying application impact

If you are unsure whether you are using v1.0 of the Box Salesforce SDK, go to the application code location where you have stored the Box Salesforce SDK and do the following:Load the following Salesforce SDK file: src/classes/BoxApiRequest.clsLook for the following lines (should be lines 6-7):
public final static String HEADER_LOCATION_LOWER_CASE = 'location';
public final static String HEADER_LOCATION_CAPITALIZED = 'Location';
If those lines are present then you are using v1.1.0 or later of the Salesforce SDK, which is not impacted and no changes are needed. If those lines are not present then you are using v1.0 of the Salesforce SDK, which will be impacted and will need to be updated.

Salesforce SDK v1 users: How to make the change

To update the impacted application(s), you will need to update the version of the Salesforce SDK that you are using. It is recommended that you upgrade to the most recent version of the SDK, but anything from v1.1.0 or later will be adequate to ensure that there is no impact to your application(s).

Where to get support

Should you have any issues or need further guidance, please file a ticket with our support team or post a request to our developer forum for any help needed.
2021-02-01

Box iOS SDK v4.3.0 released

Breaking Changes:New Features and Enhancements:
  • Add support for OAuth 2 custom callback URL (#746)
  • Add support for zip download (#749)
Bug Fixes:
  • Update gems to patch kramdown vulnerability (#742)
  • Update gems to patch activesupport vulnerability (#745)
2021-01-28

Box Node SDK v1.36.0 released

New Features and Enhancements:
  • Add folder lock functionality (#560)
  • Add support for filtering groups by name (#561)
Bug Fixes:
  • Update proxy-agent to patch proxy support issue (#563)
  • Update dependencies to patch security vulnerabilities (#566)
2021-01-25

Maximum upload file size limit increases

The maximum file size that may be uploaded via the API has been increased for the following Box account plans.
  • Business Plus
  • Enterprise
  • Digital Workplace Suite
  • Digital Workplace Global Suite
The prior maximum upload file size for these account types was 5 GB. This update increases the maximum file size to 15 GB, effective immediately.For more information on the maximum file sizes for all account plans, please refer to the direct uploads documentation.
2021-01-15

Metadata Query index changes

When making file / folder metadata query requests, a search index needs to be created for queries where more than 10,000 files / folders are being searched.To improve the efficiency and simplicity of this process, we have changed the way in which indexes are used by removing the explicit requirement to supply an index through the use_index key in a metadata query API request.There is no impact to existing applications that are currently supplying an index through the use_index key. The supplied index will be ignored in the request and the most efficient index will be automatically applied.

Previous Indexing Process

The following was the previous process for creating and using an index for a metadata query request involving 10,000+ files / folders in the search. This is the process being replaced.
  • Contact the metadata query team to request an index.
  • The metadata query team would create the index and supply back the name of the newly created index.
  • When making metadata query requests this index name was supplied as the value for the use_index key in the API request.

New Indexing Process

The following is the new process for creating and using an index.
  • Contact the metadata query team to request an index.
The use_index key within the metadata query API request has been removed. Instead, the most efficient query will be automatically applied during the search process.Indexes that are currently supplied in the use_index key will be ignored, and instead the most efficient index will be used.Application owners may safely remove the use_index key and value from their metadata query requests at their discretion.
2021-01-15

Developer Console Updates

A new Authorization tab is now available in the Developer Console. In addition, clarifying UI changes were made to the Application Access and Scope settings within the Configuration tab to ease these decisions. These changes do not impact the functionality of the settings.Now, developers will navigate to the Authorization tab to submit the application directly to their Box Admin for authorization approval.As for the Configuration tab, helpful tips were added to the JWT Application Access settings to facilitate a clear decision between App Only Access or App Access + Enterprise Access. The Scope section is now grouped by action type: content, administrative, and developer.

Updates

  • Added Authorization tab to the Developer Console
  • Updated the UI for JWT Application Access settings under the Configuration tab
  • Updated the UI grouping of Scopes under the Configuration tab
2021-01-11

Box Python SDK v2.11.0 released

New Features and Enhancements:
  • Deprecate and add method for getting a thumbnail (#572)
2021-01-09

Box Java SDK v2.53.0 released

New Features and Enhancements:
  • Add offset and limit parameters to BoxFolder.getChildren (#861)
2020-12-14

Blank OAuth 2 redirect URI change

On September 28th, 2020 we announced upcoming changes to our security requirements for OAuth 2 app redirect URIs. As of today, applications that use a blank redirect URI will no longer be permitted, and will begin to produce an error stating redirect_uri missing when attempting to redirect the user, stating that there is a mismatched URI.Impacted applications will have received multiple emails to the developer email address associated with the application and account, and are part of a small subset of applications that were grandfathered in to allow the functionality to persist.New applications, or any OAuth 2 applications that have a redirect URI specified are not impacted.

How to update your OAuth 2 app redirect URI

If your OAuth 2 application has started to produce an error during the redirect phase, you may be impacted by this change. To update your application(s), use the following steps:
  • Go to the Box developer console as the user who owns the application(s).
  • From the top navigation, click on Configuration.
  • Scroll down to the OAuth 2.0 Redirect URI section. 
  • For any application where this URI is blank, add the URI that is being used in the application code when redirecting the user back to your application from the Box auth step, as is described in this guide.
2020-12-03

New type field in search API responses

A new field, type, has been introduced in the search result response object for returned shared link items.This response object format is only returned when making calls to the content search endpoint with the include_recent_shared_links query parameter set to true.There is no impact to existing applications that are currently consuming this response object.

Updates

Prior to this release, the return object for shared link search results included two objects:
  • accessible_via_shared_link: The shared link which the item is accessible from.
  • item: The file, folder, or web link that matched the search query.
{
  "accessible_via_shared_link": "https://www.box.com/s/vfejh7y01sb263wjtgfe",
  "item": {
    ...
  }
}
This update introduces the new type field, which is a string that will always be set to search_result.
{
  "type": "search_result",
  "accessible_via_shared_link": "https://www.box.com/s/vfejh7y01sb263wjtgfe",
  "item": {
    ...
  }
}
For complete format information see the shared link search result response object.
2020-12-03

Box CLI v2.8.0 released

Warning:
  • Due to the changes in (#217), additional details about Box Items may now be returned for some commands.
New Features and Enhancements:
  • Output contents of array for bulk commands (#217)
Bug Fixes:
  • Fix bug with setting proxy settings (#218)
2020-11-24

Box Java SDK v2.52.0 released

New Features and Enhancements:
  • Add folder lock functionality (#856)
  • Add support for search parameter to get shared link items (#855)
Bug Fixes:
  • Fix bug with updating tracking codes (#857)
2020-11-17

Announcing Client Credentials Grant authentication

A new method for authenticating your JWT applications is now released. This new method, Client Credentials Grant, does not impact existing applications but offers an easier way to authenticate for new apps. Prior to today, we required a public/private key pair and assertion to verify an application’s identity and retrieve an Access Token. Now, you can request a token using only your client ID and client secret.
curl --location --request POST ‘https://api.box.com/oauth2/token’ \
--header ‘Content-Type: application/x-www-form-urlencoded’ \
--data-urlencode ‘client_id=<client_id>’ \
--data-urlencode ‘client_secret=<client_secret>’ \
--data-urlencode ‘grant_type=client_credentials’ \
--data-urlencode ‘box_subject_type=enterprise’ \
--data-urlencode ‘box_subject_id=<enterprise_id>’
For further information, please visit our guide.

Updates

  • Added client credentials grant as an auth option for new applications
  • Added 2FA requirement to copy/view client secret
  • Added selected authentication method in the Enterprise Authorization request
  • Removed the ability to change authentication type
2020-11-17

Box iOS SDK v4.2.0 released

Breaking Changes:New Features and Enhancements:
  • Add error information for disconnected OAuth web sessions
Bug Fixes:
  • Fix bug with creating collaboration
  • Fix bug with getting enterprise events
2020-11-13

Box Java SDK v2.51.1 released

Bug Fixes:
  • Fix for cross-enterprise collaborator calls to updateMetadata on files
2020-11-13

Box Content Preview v2.57.0 released

New Features and Enhancements:
  • Add react versions of core control components (#1282)
  • Add react versions of existing control icons (#1280)
  • Add react versions of fullscreen and zoom controls (#1283)
  • Add react versions of text viewer controls (#1284)
  • Add instrumentation for annotation creation (#1275)
  • Upgrade react and react-dom to ^16.9.0 (#1278)
Bug Fixes:
  • Select newly created annotation (#1276)
  • Allow download of files via embedded links in Chrome (#1277)
  • Revert pdf.js to v2.2.228 due to font rendering issue (#1274)
2020-11-09

Simplified App Creation Flow

A new, simplified app creation flow is now available in the Box Developer Console. The three types of applications are Custom Apps, Limited Access Apps, and Box Custom Skills.We added plain language to describe exactly when to select each app type and links to relevant documentation if you require additional information to help with your selection. The application type you select impacts which authentication methods are available.Most notably, is our new app type, Limited Access Apps. Select this app type if you’d like to leverage Box View or Box’s preview services within another application. This app type only provides access to app token authentication, which has restricted API capabilities. For full details, please visit our guide on selecting an app type.
2020-11-04

Box CLI v2.7.0 released

New Features and Enhancements:
  • Make commands collaborations:add, shared-links:update, shared-links:delete, users:search that were previously hidden, now available (#211)
  • Add filter_term parameter to groups:list (#210)
Bug Fixes:
  • Fix bug with setting proxy settings (#213)
2020-11-02

Box Node SDK v1.35.0 released

New Features and Enhancements:
  • Add support for search parameter to get shared link items (#547)
2020-10-29

Box Java SDK v2.51.0 released

New Features and Enhancements:
  • Add support for copyInstanceOnItemCopy field for metadata templates (#850)
  • Add support for more fields in BoxCollaborator.Info (#843)
Bug Fixes:
  • Update getAllGroupsByName() to use documented parameter (#851)
2020-10-26

New Folder Lock APIs now available

A new collections of APIs have been released to allow developers to lock move and delete operations on folders. New API reference and guides have been made available to help create and manage you folder locks.To create a lock on a folder to prevent it from being moved or deleted, supply the ID of a folder to the folder_locks endpoint.
curl -i -X POST "https://api.box.com/2.0/folder_locks" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{
       "folder": {
         "type": "folder",
         "id": "33552487093"
       }
     }'
Additional API endpoints are available to allow a developer to list all locks on a given folder, or to delete an existing folder lock with a folder lock ID.
2020-10-22

New Folder Lock APIs now available

A new collections of APIs have been released to permit the restriction of move and delete actions on folders. New API reference and guides have been made available to help create and manage you folder locks.To create a lock on a folder to prevent it from being moved or deleted, supply the ID of a folder to the POST /folder_locks/ endpoint.
curl -i -X POST "https://api.box.com/2.0/folder_locks" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{
       "folder": {
         "type": "folder",
         "id": "33552487093"
       }
     }'
Additional API endpoints are available to allow a developer to list all locks on a given folder, or to remove an existing folder lock from a folder.
2020-10-21

Metadata Cascade Policies API leaves Beta

The Metadata Cascade Policies API is now generally available to all and no longer in Beta.Over the past years, we’ve made a lot of technical improvements to our metadata infrastructure and we’re happy to announce that we’ve now gotten to the moment where the Metadata Cascade Policies API is leaving Beta. This release does not involve any breaking changes and any existing application should not see any impact from this release.Since we initially launched, Metadata Cascade Policies has become over 10 times faster when applying metadata to new instances. Additionally, we’ve also made significant strides in reliability and observability to ensure a top-notch API experience, in line with the rest of our API suite.For more details about metadata, and metadata cascade policies, please visit the Metadata guides and our dedicated Metadata Cascade Policies reference documentation.
2020-10-19

Box Windows SDK v3.25.0 released

3.25.0 [2020-10-19]

New Features and Enhancements:
  • Add support for filtering when getting Groups (#703)
  • Add zip functionality (#700)
  • Deprecate one of the overloaded ExecuteMetadataQueryAsync() methods (#699)
  • Add support for copyInstanceOnItemCopy field for metadata templates (#698)
Bug Fixes:
  • Fix bug with JWT Authentication automatic retry (#697)
www.nuget.org/packages/Box.V2/3.25.0 www.nuget.org/packages/Box.V2.Core/3.25.0
2020-10-08
The Search API now supports returning files, folders and web links that the user has recently accessed through a shared link.Shared items can be requested by calling the GET /search API with the new include_recent_shared_links query parameter set to true.
curl -i -X GET https://api.box.com/2.0/search?query=Contract&include_recent_shared_link=true
By default, the API won’t return any shared items if this query parameter is not provided or not set to true.

Change in response format

When include_recent_shared_links is set to true, the response has slightly changed to allow for the additional information to be returned. Rather than returning a direct list of files, folders, and web links the API now returns a list of objects containing an item and an accessible_via_shared_link property.This change in response format should not impact any existing applications as it only applies to any API call made with the new query parameter.
2020-10-05

Box Node SDK v1.34.3 released

Bug Fixes:
  • Upgrade ajv dependency (#545)
2020-10-02

New File Request APIs available

A new collection of APIs are now available that allows developers to create and update File Requests. We’ve updated the reference documentation and added new guides to help you manage your file requests.To create a copy of an existing file request, all you need is the unique ID of an existing file request, and the ID of the folder to apply the new request to.
curl -i -X POST "https://api.box.com/2.0/file_requests/42037322/copy" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -d '{
       "folder": {
         "id": "2233212"
       }
     }'
Additional APIs are available that allow a developer to get more details about a file request, update a file request, and delete a file request. For more details, please check out the developer documentation.
2020-10-02

Box Python SDK v2.10.0 released

New Features and Enhancements:
  • Add support for copyInstanceOnItemCopy field for metadata templates (#546)
  • Allow creating tasks with the action and completion_rule parameters (#544)
  • Add Zip functionality (#539)
Bug Fixes:
  • Fix bug with updating a collaboration role to owner (#536)
  • Allow ints to be passed in as item IDs (#530)
2020-10-29

Change to OAuth 2 app redirect URI requirements

On October 29th, 2020, Box will begin employing stricter requirements for redirect URIs used within new and existing OAuth 2-based Box integrations that may affect your application.Existing application owners that currently use a blank redirect URI in their application configuration, as described here, will need to update the redirect URI to match the redirect used within the code redirect step, described here.On October 29th, 2020, applications that are still configured with a blank URI will begin returning an error when the user is redirected back to your application if URI adjustments aren’t made.All impacted application owners and collaborators have been notified via the email address associated with their developer account.

How to validate and make the change

To validate your redirect URI and update your application(s) if they are affected, take the following steps:
  • Go to the Box developer console as the user who owns the application(s).
  • For each Custom App using OAuth 2 (client-side authentication) click on the application to open it.
  • From the left navigation, click on Configuration.
  • Scroll down to the OAuth 2.0 Redirect URI section. 
  • For any application where this URI is blank, add the URI that is being used in the application code when redirecting the user back to your application from the Box auth step, as is described in this guide.
2020-09-25
The Search API now supports returning files, folders and web links that the user has recently accessed through a shared link.Shared items can be requested by calling the GET /search API with the new include_recent_shared_links query parameter set to true.
curl -i -X GET https://api.box.com/2.0/search?query=Contract&include_recent_shared_link=true
By default, the API won’t return any shared items if this query parameter is not provided or not set to true.

Change in response format

When include_recent_shared_links is set to true, the response has slightly changed to allow for the additional information to be returned. Rather than returning a direct list of files, folders, and web links the API now returns a list of objects containing an item and an accessible_via_shared_link property.This change in response format should not impact any existing applications as it only applies to any API call made with the new query parameter.
2020-09-10

Group API adds new filter and permissions

The GET /groups API now supports filtering groups by name using a new filter_term field.
curl -i -X GET "https://api.box.com/2.0/groups?filter_term=Engineering" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"
Additionally, all the Group endpoints now allow a developer to request a new permissions field, which currently has one attribute defining if the authenticated user can invite the group to any item.
curl -i -X GET "https://api.box.com/2.0/groups?field=permissions" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"
{
    "total_count": 1,
    "entries": [
        {
            "type": "group",
            "id": "223353242",
            "permissions": {
                "can_invite_as_collaborator": true
            }
        }
    ],
    "limit": 100,
    "offset": 0
}
For more details about how to work with groups, please visit the Group API documentation.
2020-08-25

New multiSelect metadata support in search API

Starting today, the Search API adds support for matching items by multiple values of a multiSelect metadata field. Before this change, it was not possible to find items by the value of a multiSelect field.To perform a search for items where a metadata field matches multiple values, the mdfilters parameter now supports a list of values.
curl -G 'https://api.box.com/2.0/search' \
     -H 'Authorization: Bearer <ACCESS_TOKEN>' \
     -d 'mdfilters=[{"scope":"enterprise_12345","templateKey":"contractInfo","filters":{"products":["shield","platform"]}}]'
In this example, the mdfilters query parameter contains one filter with a scope, a templateKey, and a set of filters. Here is the same filter in a more readable format.
[
  {
    "scope": "enterprise_12345",
    "templateKey": "contractInfo",
    "filters": {
      "products": [
        "shield",
        "platform"
      ]
    }
  }
]
What is new here is that the products filter now performs a match on multiple values, only returning files and folders for which the template has a products value of either shield or platform. The value of the field can contain multiple values and only match on one of the values specified in the filter. For example ["shield", "governance"] will be a match for the filter ["shield", "platform"] as shield is included in the filter.
2020-08-21

Box CLI v2.6.0 released

CHANGELOG
  • Add zip functionality (#203) 1953639
  • Add proxy support for http, https, socks and pac protocols. Proxy settings can be found under box configure:settings (#202) 21671c8
  • Fix filename issue when saving reports on Windows (#195) 31853d3
https://github.com/box/boxcli/compare/v2.5.1…v2.6.0
2020-08-20

Box Node SDK v1.34.2 released

  • Make iterator bug fix for uploading files non breaking (#534) b0baa18
https://github.com/box/box-node-sdk/compare/v1.34.1…v1.34.2
2020-08-20

Box Java SDK v2.50.1 released

Fix bug that occurred when downscoping a token for a Box folder (#832)
2020-08-17

Box Node SDK v1.34.1 released

  • Fix iterator bug for uploading new file versions (#531) 69b1387
https://github.com/box/box-node-sdk/compare/v1.34.0…v1.34.1
2020-08-07

Box Node SDK v1.34.0 released

  • Add zip functionality (#525) 2f89357
  • Add proxy support for HTTP, HTTPS, SOCKS and PAC protocols (#529) b08cc24
https://github.com/box/box-node-sdk/compare/v1.33.0…v1.34.0
2020-01-31

Updates to Search Relevance & Performance

In January, updates were released to Box’s search tokenizer, improving the relevancy of search results and performance. This change does not effect how metadata is tokenized.Notable changes to the API-initiated searches include:
  • The ability to use “stop words”, for example “the”, “is” “at”, “which”, and “on”.
  • Improved Japanese text tokenization and improved search results.
See the full-text search documentation for more information on how to search using Box’s API.
2020-07-22

New Zip Download APIs available

A new collection of APIs are now available that allows developers to create a Zip file containing a specified list of files and folders. We’ve updated the reference documentation for this Zip Download API. SDK support for these new endpoints is currently in development and scheduled to be released in the next 3 months.
2020-07-22

Box Java SDK v2.50.0 released

v2.50.0
  1. Add retries on request creation errors (#828)
2020-07-17

Box Java SDK v2.49.0 released

  1. Add fields parameter for metadata query (#826)
  2. Add zip functionality (#825)
  3. Fix bug with setting the unshared at date for a shared link (#819)
2020-07-16

Change to enterprise events for content access

Starting today, the enterprise event stream will begin producing new content access events.A new CONTENT_ACCESS event is triggered when a file was accessed by an authorized user or programmatically by a Box application.See the enterprise events documentation for more information on other event types.
2020-07-15

Changes to Metadata Query API syntax

The Metadata Query API has been updated to require explicitly defined response fields.
curl -X POST https://api.box.com/2.0/metadata_queries/execute_read \
      -H 'Authorization: Bearer <ACCESS_TOKEN>" '
      -H 'Content-Type: application/json'
      -d '{
        "from": "enterprise_123456.customerInfo",
        "query": "tav >= :value",
        "query_params": {
          "value": 200000
        },
        "fields": [
          "name",
          "metadata.enterprise_123456.customerInfo.tav"
       ],
        "ancestor_folder_id": "0"
      }'
Additionally, the response format now returns a list of items rather than a list of query results. Any metadata is now nested within the item, rather than listed side-by-side with the item. Only fields specified in the field array - as well as any base fields - are returned in the response.
{
  "entries": [{
    "id": "394384323",
    "type": "file",
    "etag": 1,
    "name": "Contract.pdf",
    "metadata": {
      "enterprise_123456": {
        "customerInfo": {
          "$parent": "folder_12345,",
          "$scope": "enterprise_123456",
          "$template": "customerInfo",
          "$version": 1,
          "tav": 1000000
        }
      }
    }
  }]
}

Legacy syntax

For reference, the API would previously return all standard fields for an item as well as the matched metadata.
curl -X POST https://api.box.com/2.0/metadata_queries/execute_read \
      -H 'Authorization: Bearer <ACCESS_TOKEN>" '
      -H 'Content-Type: application/json'
      -d '{
        "from": "enterprise_123456.customerInfo",
        "query": "tav >= :value",
        "query_params": {
          "value": 200000
        },
        "ancestor_folder_id": "0"
      }'
The response body previously returned the items as a list of entries, each containing an item and a metadata instance.
{
  "entries":[
    {
      "item":{
        "type":"file",
        "id":"394384323",
        "name": "Contract.pdf",
        "file_version":{
          "type":"file_version",
          "id":"33482348",
          "sha1":"69888bb1bff455d1b2f8afea75ed1ff0b4879bf6"
        },
        ...
      },
      "metadata":{
        "enterprise_123456":{
          "customerInfo":{
            "tav": 1000000,
            "$id": "01234500-12f1-1234-aa12-b1d234cb567e",
            "$parent": "folder_12345,",
            "$scope": "enterprise_123456",
            "$template": "customerInfo",
            "$type": "customerInfo-6bcba49f-ca6d-4d2a-a758-57fe6edf44d0",
            "$typeVersion": 2,
            "$version": 1,
            "$canEdit": true
          }
        }
      }
    },
    ...
  ],
  "limit": 20,
  "next_marker":"AAAAAmVYB1FWec8GH6yWu2nwmanfMh07IyYInaa7DZDYjgO1H4KoLW29vPlLY173OKsci6h6xGh61gG73gnaxoS+o0BbI1/h6le6cikjlupVhASwJ2Cj0tOD9wlnrUMHHw3/ISf+uuACzrOMhN6d5fYrbidPzS6MdhJOejuYlvsg4tcBYzjauP3+VU51p77HFAIuObnJT0ff"
}
This legacy syntax will still be available for any existing Metadata Query API users only. The legacy syntax will be turned off When all existing customers have been migrated over to the new syntax.
2020-06-25

Box Node SDK v1.33.0 released

  • Add path parameter sanitization (#505) 46b780a
  • Add support for all streams for uploading files (#519) 93a27ec
https://github.com/box/box-node-sdk/compare/v1.32.0…v1.33.0
2020-06-24

Box Java SDK v2.48.0 released

v2.48.0
  1. Add ability to get groups by name with fields option (#789)
  2. Add shared link downscoping (#785)
  3. Deprecate the use of float for Metadata values, in preference of the underlying value (double) (#811)
  4. Add iterator support for group collaborations (#813)
  5. Add ability to set the filename when uploading a new version of a file (#810)
  6. Add support for the classification field for Files and Folders (#809)
  7. Add support for setting Tracking Codes (#766)
  8. Fix issue for getIsExternallyOwned() for Files and Folders (#808)
2020-06-23

Box Python SDK v2.9.0 released

  • Fix exception handling for OAuth
  • Fix path parameter sanitization
2020-06-11

Change to enterprise events for tasks

Starting today, the enterprise event stream will begin producing new task and task assignment events, and some existing task events will return additional fields.

New events

  • A new TASK_UPDATE event is triggered when a task is updated
  • A new TASK_ASSIGNMENT_DELETE event is triggered when a task is unassigned from a user

Updated events

Changes to TASK_CREATE

When a task is created, the event now includes the task’s ID (task.id), the ID of the user who created the task (task.created_by.id), the task’s description (task.message), and the optional due date of the task (task.due_date) within the additional_details object.
"additional_details": {
  "task": {
    "id": "1234567",
    "due_at": "2020-07-06T10:49:44-07:00",
    "message": "task description",
    "created_by": {
      "id": 123456,
      "login": "email@example.com"
    },
    ...
  }
}

Changes to TASK_ASSIGNMENT_CREATE and TASK_ASSIGNMENT_UPDATE

When a task assignment is created or updated, the event now includes the task’s ID (task.id), the ID of the assigned user (task_assignment.assigned_to.id) and their login (task_assignment.assigned_to.login), the task’s description (task.message), and the optional due date of the task (task.due_date) within the additional_details object.
"additional_details": {
  "task": {
    "id": "1234567",
    "created_by": {
      "id": 12345,
      "login": "email@example.com"
    }
  },
  "task_assignment": {
    "assigned_to": {
      "id": 12346,
      "login": "email+2@example.com"
    },
    "status": "NOT_STARTED",
    "message": "assignee message"
  },
  ...
}
See the enterprise events documentation for more information on other event types.
2020-05-15

Box iOS SDK v4.1.0 released

Box iOS SDKBreaking Changes:New Features and Enhancements:
  • Add ability to cancel uploads and downloads
  • Add support for the uploader display name field for Files and File Versions
  • Add support for the classification field for Files and Folders
  • Add path parameter sanitization
Bug Fixes:
  • Fix logging of API responses
2020-05-12
2020-05-12

New shield alert events

As of today, Box Shield will begin producing new security events within the enterprise event stream for Shield customers who are configured to listen for the new events.The possible incident events produced by Shield are:
  • Suspicious locations
  • Suspicious sessions
  • Anomalous download
  • Malicious content
See the shield alert events documentation for more information on the payloads produced within these events.
2020-04-24

Python SDK v2.8.0 released

  • Added support for token exchange using shared links
  • Added the ability to pass in a SHA1 value for file uploads
2020-04-23

New classification field for Files

A new optional field has been made available within the Field object, classification. This field represents the classification that is currently applied to a file.The classification can be requested via any endpoint that returns a file, like the Get file information and supports requesting additional fields.
{
  "id": "123456789",
  "type": "file",
  "etag": "1",
  "classification": {     
    "name": "Top Secret",     
    "definition": "Content that should not be shared outside the company.",
    "color": "#FF0000"
  },
  ...
}
The classification can be set through the API, Box Shield, or by a user using the web application.
2020-04-23

Java SDK v2.47.0 released

  1. Fix path parameter sanitization (#797)
  2. Add support for the uploader display name field for Files and File version (#791)
2020-04-23

Add new uploader_display_name field to file and file versions

A new field, uploader_display_name has been added to both file and file version resources. This field provides the name of the user at the time of upload.
{
  ...
  "uploader_display_name": "Ellis Wiggins"
}
This field can be requested on any of the file and file version endpoints by providing the fields query parameter, for example:
curl -X GET https://api.box.com/2.0/files/12345?fields=uploader_display_name \
     -H 'Authorization: Bearer <ACCESS_TOKEN>'
When the file is uploaded by a logged out anonymous, the email of the user is returned instead. If no email is available then the field will default to the text Someone.
2020-04-21

New Metadata Query APIs available

A new API is now available that allows developers to query files and folders by the metadata attached to them. We’ve updated the reference documentation for this Metadata Query API, as well as released some brand new guides and an update to the metadata quick start guide.
2020-04-21

Box CLI v2.5.1 released

CHANGELOG
  • Added --quiet flag to suppress any non-error output to stderr (#167) 27045c6
  • Fixed a bug for the --restrict-collaboration flag for box folders:update where previously the flag would not restrict the collaborations when passed as true and would restrict collaborations when passed as false (#175) e6e1120
  • Added box trash:restore to restore a trashed item and box trash:get to get information on a trashed item (#179) 74db947
  • Fixed a bug where flags that can be specified multiple times in a single command could not be passed through the command line for bulk commands (#183) 63db0ac
  • Note: Skipped version 2.5.0 due to development of new release process
v2.4.0...v2.5.1
2020-04-09

Java SDK v2.46.0 released

  1. Fix retry logic (#787)
  2. Add path parameter sanitization (#790)
  3. Add ability to set expiration date for a collaboration (#788)
2020-04-02

Java SDK v2.45.0 released

  1. Add preflight check before chunked uploads (#782)
  2. Check that part was successfully uploaded for large file uploads… (#781)
  3. Fix bug with unexpected disconnect in File Rename (#779)
  4. Return metadata for each item returned by a metadata query (#778)
2020-04-01

Node SDK v1.32.0 released

  • Temporarily removed Node 4 and Node 5 builds from Travis, due to tests not passing. Will investigate, going forward (#495). dc558e9
  • Fixed an issue where an error is thrown during a retry when a response is not returned by the previous call (#477). f1b3449
  • Added the ability to query Box items based on their metadata (#487). 6f08931
v1.31.0...v1.32.0
2020-03-30

Potential impactful changes to format of Metadata date fields

As part of ongoing improvements to our Metadata infrastructure we will be rolling out three potential impactful changes to the format of date fields in metadata templates. These changes make the format our API returns more consistent between API calls.The first change affects the usage of time zone offsets in dates. Previously, the API would inconsistently return dates with and without timezone offsets if a date was set to include one. From now on all dates are converted to UTC / Zulu-time, removing the timezone offset.For example:
  • Assume a date was set to 2020-02-20T12:00:00.000-01:00
  • Previously the API would return 2020-02-20T12:00:00.000-01:00 (the original value) or 2020-02-20T13:00:00.000Z (the UTC adjusted value)
  • From now on it will always return 2020-02-20T13:00:00.000Z (the UTC adjusted value)
The second change affects the sub-second precision of dates returned by the metadata API. Previously, the API would return values with 0 to 3 digits of sub-second precision. From now on Box will always return metadata date-time values with millisecond precision.For example:
  • Previously the API might return 2020-02-20T12:00:00Z, 2020-02-20T12:00:00.0Z, 2020-02-20T12:00:00.00Zor 2020-02-20T12:00:00.000Z
  • From now on it will always return 2020-02-20T12:00:00.000Z
The final change affects the usage of the test operation when updating a metadata instance. Previously the test would compare the date-time values using the literal string value. After this update they are compared using their UNIX timestamp in milliseconds.For example:
  • Previously 2020-01-21T19:20:00.123-08:00 would not be equivalent to 2020-01-22T03:20:00.123Z
  • From now on 2020-01-21T19:20:00.123-08:00 is equivalent to 2020-01-22T03:20:00.123Z

How this can affect an application

Any application that implements RFC3339-compliant date-time parsing will not need to perform any action as these are all valid RFC3339 values representing the same dates. Any application that does not implement RFC3339 compliant date-time parsing should be updated to do so.All official Box SDKs support RFC3339-compliant date-time parsing, so any application using an up-to-date version of an official Box SDK would not require any update.

What do if this affected your application

Roll-out of this change will be performed gradually over the next few weeks. Although the metadata team will be monitoring potential impact, please reach out to your customer success manager or our support channels if you find yourself impacted.
2020-03-30

Change to metadata instance version

As part of ongoing improvements to our Metadata infrastructure we will be rolling out a small change to the version value of a metadata Instance.Previously, the version number associated with a metadata instance would be incremented if a field on the associated metadata template was deleted, or if an enum field’s option was deleted on the associated metadata template.Going forward, these changes will not increment the version number of a metadata instance.This behavior has always been implicit and we recognize that very little value can be derived form to the metadata instance version. Therefore we do not expect this change to have any impact on any of our customers. Regardless, please reach out to your customer success manager or our support channels if you find yourself impacted.
2020-02-25
2020-02-14

Node SDK v1.31.0 released

  • Fix Authentication Request Retries (#454) dd3253e
  • Added marker-based paging for users endpoints (#461) 055cb5b
  • Added getNextMarker() to PagingIterator to get the next marker (#461) 055cb5b
v1.30.0...v1.31.0
2020-02-13

Java SDK v2.44.1 released

  1. Fix formatting bug for Java Logger (#775)
  2. Improve date / time parsing for responses (#772)
2020-02-13

Box iOS SDK v4.0.0 released

Box iOS SDKBreaking Changes:
  • Change status field for task assignments from a String to an Enum
  • Remove macOS, tvOS, and watchOS support
New Features and Enhancements:
  • Make authentication session classes OAuth2Session, SingleTokenSession, and DelegatedAuthSession public
2020-02-03
Preview SDK v2.34.0 released
Version 2.34.0 of the Preview SDK has been released. New JavaScript and CSS Preview files have been made available. To adopt new changes, please see the UI Elements manual installation links for Content Preview.Please see the v2.34.0 release notes for a list of all feature changes.
2020-01-22

Python SDK v2.7.1 released

  • Fixed bug in _get_retry_request_callable introduced in release 2.7.0 which caused chunked uploads to fail
2020-01-22
Preview SDK v2.33.1 released
Version 2.33.1 of the Preview SDK has been released. New JavaScript and CSS Preview files have been made available. To adopt new changes, please see the UI Elements manual installation links for Content Preview.Please see the v2.33.1 release notes for a list of all feature changes.
2020-01-21

Java SDK v2.44.0 released

  1. Fix Authentication Request Retries (#764)
2020-01-20
Refreshed Postman Collection & Quick Start
The Box Postman collection has been updated with new features and an integrated quick-start guide. Key features include:
  • An end-to-end Postman quick-start guide that helps users to install Postman, set up a Box App, and load their API credentials into Postman.
  • A restructured Postman collection for the Box APIs that automatically detects when API credentials have expired and offers integrated solutions for refreshing these credentials when needed.
The legacy Postman collection will stay available for the foreseeable future.
2020-01-16

Python SDK v2.7.0 released

  • Fixed bug in get_admin_events function which caused errors when the optional event_types parameter was omitted.
  • Add marker based pagination for listing users.
  • Added support for more attribute parameters when uploading new files and new versions of existing files.
  • Combined preflight check and lookup of accelerator URL into a single request for uploads.
  • Fixed JWT retry logic so a new JTI claim is generated on each retry.
  • Fixed bug where JWT authentication requests returned incorrect error codes.
  • Fixed retry logic so when a Retry-After header is passed back from the API, the SDK waits for the amount of time specified in the header before retrying.
2019-12-30

EOL of Classic Relay API Endpoints

As previously communicated on October 18 2019, Classic Relay API endpoints are officially at an end of life state as of today.The following endpoints are affected by this EOL and will now start responding with error responses in applications making requests to them:
  • Get list of published Relay Classic templates.
  • Get list of Relay Classic workflows.
  • Launch a Relay Classic workflow.
For any application encountering these error responses, please remove all calls to the Relay Classic APIs listed above.
2019-12-20

Java SDK v2.43.0 released

  1. Throw exceptions for setMetadata on Files and Folders for non 409 errors (#762)
2019-12-17

Java SDK v2.42.0 released

  1. SDK-1168 Metadata Query (#760)
  2. Add marker based pagination for get users methods (#759)
2019-12-06
2019-12-05

Marker-based Pagination Support for Users API

The Users API now supports marker-based pagination. Marker-based pagination is an alternative to regular offset-based pagination and provides an alternative way to get users for enterprises with a large volume of users.
2019-12-03

Preview SDK v2.29.0 released

Version 2.29.0 of the Preview SDK has been released. New JavaScript and CSS Preview files have been made available. To adopt new changes, please see the UI Elements manual installation links for Content Preview.Please see the v2.29.0 release notes for a list of all feature changes.
2019-11-26

Box UI elements v11.0.2 released

11.0.2 (2019-11-26)

Bug Fixes

  • build: outdated release package (991ee17)
2019-11-25

Elements v11.0 Released

Box UI Elements version 11.0 has been released. This update includes three major new feature enhancements:
  • Content Explorer Grid View.
  • New Tasks Experience within the Preview Sidebar.
  • Visual Versions for the Preview Sidebar.
Updated JavaScript and CSS files links for this release are available within the UI Elements manual installation instructions.For full information on changes in this release please see the following resources:
2019-11-21

Node SDK v1.30.0 released

v1.29.1...v1.30.0
2019-11-20
Preview SDK v2.26.0 released
Version 2.26.0 of the Preview SDK has been released. New JavaScript and CSS Preview files have been made available. To adopt new changes, please see the UI Elements manual installation links for Content Preview.Please see the v2.26.0 release notes for a list of all feature changes.
2019-11-18

New iOS SDK now available

A new major release of the iOS SDK has been released and is now generally available. The new SDK includes a number of major revisions:
  • Fully rebuilt using Swift.
  • Support for Cocoapods, Carthage, and the Swift Package Manager.
  • SDK now maintains full API feature parity.
See the release blog post for more information.
2019-11-09

Box UI elements v11.0.0 released

11.0.0 (2019-11-09)

Bug Fixes

  • activity-feed: fix long user names in tasks/comments in Edge (#1604) (572e4d7)
  • activity-feed: Fix version ordering in Activity Feed (#1272) (533c112)
  • activity-feed: refactor inline error for feed items and empty state (#1697) (2702367)
  • annotation: Fix header by adding selector used by box-annotations (#1637) (9302486)
  • app-activity: Remove underscores from resin feature name (#1456) (b7c21e7)
  • app-activity: Update app activity to match comment/task (#1449) (b58aa2f)
  • arrow-stepper: Fix arrow stepper in KeyBinding component (#1654) (a05b015)
  • avatar: fix avatar initials v-alignment (#1311) (23e6d5f)
  • avatar: Fix avatar resolution in activity sidebar (#1243) (88a5f1c)
  • avatar: use derived state instead of effect for URL change (#1643) (f89c138)
  • bdl: Add SCSS check for color variable name (#1514) (a4f446f)
  • bdl: adjust font weights to match normal and bold lato (#1517) (35a4070)
  • beta-feedback: update aria-labelledby attribute name (#1249) (c164aec)
  • breadcrumb: add missing import (#1657) (fec4735)
  • button: remove horizontal margin from buttons (#1362) (a6989a0)
  • button: revert remove horizontal margin from buttons (#1362) (#1400) (3ac424c)
  • classification: badge should not have a tabindex (#1622) (4ab0c20)
  • classification: Classification badge UX tweaks (#1378) (fa82a8d)
  • classification: classification tooltip not showing in IE11 (#1710) (d08b53c)
  • classification: flow definitions for onclick (#1712) (9e620ce)
  • classification: Restoring classification badge icons (#1390) (5db4b3e)
  • collaborator-avatars: add keyboard accessibility (#1680) (baefaed)
  • collapsible: should be pure component (#1407) (5e32c80)
  • comment: Add height to comment area to support multiple mentions (#1474) (e270131)
  • comment: padding and a11y adjustments for comment UI (#1358) (927a34a)
  • comment: remove redundant aria-label (#1291) (ef48f88)
  • comment: use overlay z-index for confirmation dialog (#1270) (bcf2852)
  • comments: format existing mentions in editor (#1469) (6b82510)
  • constants: explicit type import (#1584) (7d38fb8)
  • content-explorer: ContentExplorer and ContentPicker can handle sharing web links now (#1515) (55edef7)
  • content-explorer: MDVGridView import fixes (#1333) (9740342)
  • content-explorer: rows no longer stuck after closing modal (#1245) (d7f53ff)
  • content-preview: remove deeplink path upon navigation (#1665) (84b4ea4)
  • content-uploader: Disable cancel button when 100% is reached (#1511) (a6de1b0)
  • content-uploader: Fix cancelling task triggers the others to start (#1653) (f35b2ea)
  • content-uploader: Fix duplicate files upload at the same time (#1652) (6faed59)
  • datetime: add missing support for times w/o ms (#1191) (19f3703)
  • deps: downgrade axios peer dependency (#1329) (d1a1bd9)
  • examples: change colors to the current box design language (#1281) (94869ad)
  • explorer: fetch shared link on demand (#1479) (2d29628)
  • feed: inline error for deeplinking feed items (#1655) (e2be3bd)
  • feed: Task assignee names not truncating IE11 (#1694) (a20e610)
  • floatfield: always allow trailing . for float field (#1178) (61d4e3d)
  • footer-indicator: move tooltip to appear above footer indicator (bf7782c)
  • header-flyout: Constraint to window to fix IE11 scroll bug (#1310) (f8bb323)
  • i18n: change “accepted” copy to “approved” (#1214) (674bf45)
  • i18n: Fix bug where messages starting with HTML cause an exception (#1490) (73d95b9)
  • i18n: Param and Plural should not be in the styleguide.conf (#1197) (2d34ad4)
  • i18n: use plural format for task assignee message (#1345) (10d6b76)
  • icons: fill in background for globe icon (#1226) (c91d320)
  • icons: fix collections icons for left navigation usability (#1238) (9e91115)
  • icons: give collections Icons SUIT classNames (#1242) (3b62245)
  • icons: update retry and public icon (#1297) (bfa075a)
  • icons: update trash, move/copy, add, download, upload, collections (#1702) (b126ecb)
  • icons: updating add icon style and adding hidden eye icon (#1266) (b47e22e)
  • iconworkflow: make background rectangle same as viewBox (#1241) (9e07f2e)
  • inlinenotice: update to box design standard (#1576) (a814657)
  • item-properties: Add aria-labelledby to description textarea (#1229) (05d86b1)
  • left-sidebar: add key to drop wrapper for links (#1299) (9c78135)
  • left-sidebar: Adjust margins for loading indicator (#1545) (6ba65c6)
  • left-sidebar: hide toggle icon on medium screen size (#1344) (716fe01)
  • media: increase specificity of Media-button CSS to avoid .btn-plain (#1463) (943638d)
  • mention-selector: Fix hasReceivedFirstInteraction logic (#1434) (afd94fa)
  • menu: Fix padding for menu item buttons (#1446) (5baeb5b)
  • menu: Menu should only autofocus on mount if visible (#1175) (2ba8a1d)
  • metadata: Show autocomplete for metadata input fields (#1629) (85995cd)
  • metadata: template dropdown scrollbar issue in safari (#1192) (1dc0d99)
  • metadata-sidebar: bind onApiError properly (#1713) (50b72f2)
  • modal: move close button after header for better screen reader a11y (#1684) (29a1220)
  • nav-sidebar: reduce size of toggle button to fix focus outline (#1305) (9a14ae7)
  • notifications: add accessibility attributes (#1682) (21af355)
  • open-with: better error messaging (#1489) (d3d98a5)
  • pill-selector: Allow copy pasting line separated values (#1350) (7933932)
  • pill-selector: expose onInput to catch input (#1450) (48d22a4)
  • pill-selector: UX tweaks (#1315) (e4fdf58)
  • pill-selector-dropdown: disable pills when PillSelector is turned off (#1357) (2bf496e)
  • pill-selector-dropdown: fix aria attributes (#1681) (1e0d1ab)
  • pill-selector-dropdown: Fix for pills getting removed on click (#1367) (d67fcfe)
  • pills: Fix vertical centering of pill selector input text (#1364) (d47c69c)
  • pillselectordropdown: support paste from context menu (#1597) (d16b0da)
  • preview: Clean up preview header styles and remove extra borders (#1484) (6c1a363)
  • quick-search: update border radius to follow BDL (#1439) (936f5e0)
  • radio-group: fix radio group by passing the value prop (#1452) (c0c05be)
  • radio-group: pass rest of props to radio input (#1448) (85ca38a)
  • scripts: Build and update all files prior to push (#1415) (e432c47)
  • scroll-if-needed: fix scroll-if-needed on selector dropdown (#1280) (3776dc8)
  • search: Remove rounded corners for ContentExplorer search (#1478) (7d9100b)
  • security: Upgrade axios to address security vulnerability (#1228) (db26743)
  • security-badge: Fixing SecurityBadge flow type (#1664) (ae23f01)
  • select-field: Enable arrow scrolling in select fields (#1671) (9f040f2)
  • sidebar: Add flex-shrink 0 to comment input (#1359) (cd840f4)
  • sidebar: add markup and accessibility to tab list (#1563) (f90a0d7)
  • sidebar: Fix deeplinking for version history sidebar (#1649) (e85e57a)
  • sidebar: Fix sidebar not auto-opening for large viewports (#1508) (dac39ee)
  • sidebar: Limit maximum height of additional tabs in sidebar navigation (#1557) (e7f953e)
  • sidebar: More semantically accessible tabs (#1236) (eb398fc)
  • sidebar: padding on item properties versions (#1263) (853e106)
  • sidebar: removing unwanted parenthesis in empty state (#1645) (824f390)
  • sidebar: Set contaminated state if the sidebar was forced open (#1366) (e71409c)
  • sidebar: Update flexbox for Activity Feed Container (#1341) (c5e07b1)
  • subheader: Add logic around grid view (#1659) (7a53050)
  • task: string for task completed rule icon (#1573) (79c3f00)
  • task-form: clear task assignee autocomplete on form submit (#1605) (63efa10)
  • task-form: disallow text input in date picker (#1540) (af49827)
  • task-form: don’t disable task form submit button (#1323) (9a4137b)
  • task-form: Update error message when leaving not valued but required field (#1353) (be10f37)
  • task-new: alignment fixes, CSS refactor (#1312) (411c3e9)
  • task-new: fix placement of task status checkmark (#1321) (9f554ff)
  • task-new: Minor visual tweak to add tasks menu (#1334) (95a3c73)
  • task-new: Minor visual tweaks to add tasks menu (#1328) (cf1acf1)
  • tasks: add missing resin component (#1513) (00e9707)
  • tasks: assignee input field interactions (#1621) (dc33967)
  • tasks: comments menu does not appear on activity sidebar in preview (#1250) (be7bc2f)
  • tasks: fix task issues (#1189) (630fd38)
  • tasks: modal closing on resize (#1603) (2cbe014)
  • tasks: prevent resize of assignee avatar (#1332) (4e760f7)
  • tasks: Update copy for task type subtext (#1627) (c788770)
  • tasks_new: add missing resin component (#1295) (dbbf598)
  • tasks-new: Reset selector contacts on modal close (#1301) (f387a9b)
  • tasks-new: show “a prior collaborator” for deleted users (#1313) (c61fa77)
  • tasks-new: task actions are not updating (#1302) (2f88e96)
  • tasks-new: update documents and strings (#1317) (6560b23)
  • template-dropdown: add onMenuToggle handler to TemplateDropdown (#1318) (2cdfcc4)
  • text-input: looses focus when tooltip toggles (#1185) (8a4c294)
  • tooltip: color contrast and layout fixes (#1692) (1c11770)
  • unfied-share-modal: shared link access levels (#1647) (732a1dd)
  • unified-share-modal: add constraints to modal menus (#1196) (6501413)
  • unified-share-modal: classification in title (#1453) (4ce5a06)
  • uploader: MultiputUploads stop hanging in IE11 (#1283) (c49e52f)
  • uploads: cancelling in-progress tasks does not start pending ones (#1570) (dbf115c)
  • uploads: Fix hanging on resuming uploads (#1695) (3da93c8)
  • uploads: Remove logic gate (#1646) (38d10e4)
  • uploads: reset item error after retry (#1600) (0218f10)
  • uploads: resin for canceling uploads (#1397) (16311dc)
  • user-link: allow wrapping of long user names (#1602) (bff49bb)
  • usm: “Link Settings” should not line wrap (#1674) (938c483)
  • usm: Add itemTypedId to onPillCreate (#1320) (c4149ea)
  • usm: Do not pass itemTypedID to getContactsByEmail (#1354) (e60b020)
  • versions: Disable prior version preview for watermarked files (#1405) (9a527f2)
  • versions: Display date and name for most relevant version action (#1568) (b68eccd)
  • versions: Fix infinite load due to destroyed API factory (#1347) (95949e2)
  • versions: Fix version groups collapsing prior months/years (#1365) (65d23b9)
  • versions: Improve experience for restored vs promoted versions (#1631) (25d0741)
  • versions: Relax restrictions for watermarked files (#1342) (2487b42)
  • versions: Reload the page when a version is promoted (temporary) (#1395) (de7e74e)
  • versions: Restrict actions and preview for watermarked files (#1339) (fcb390d)
  • versions: Restrict preview for watermarked files (#1351) (93b95c4)
  • versions: Retrieve and use file version permissions for actions (#1193) (9d7567e)
  • versions: Scroll version button into view if selected (#1276) (e0cd7e3)
  • versions: Show server errors without hiding version history (#1275) (ef3b2fd)
  • versions: Update version actions to avoid unnecessary buttons (#1556) (bc9672e)
  • versions: Update version sidebar to use latest retention schema (#1662) (fa66232)
  • Adding Accept-Language header for Xhr.js (#1368) (361d73f)
  • show tooltip on hover long text (#1230) (c41dd47)
  • slight adjust in check mark alignment (#1678) (cfd055b)
  • various form accessibility improvements (#1688) (150cbbe)
  • versions: Update versions restore call to match latest contract (#1198) (2e590d3)

chore

Code Refactoring

  • Upgrade react and react-dom to v16.8 and refactor Avatar (#1171) (7dd1bdf), closes #761
  • deps: Upgrade peer dependencies to latest working versions (#1180) (48d711e)

Features

  • activity-feed: add support for deeplinking tasks and comments (#1623) (52ecdcb)
  • additional-tabs: gray out turned off apps (#1503) (132782d)
  • avatarinitials: move backgroundColor into SCSS (#1585) (781a246)
  • bdl: Add script for SCSS bdl scoping (#1546) (9bdc1e6)
  • classification: change icon for classify/classification action (#1520) (8eb68b3)
  • classification: new badge and layout (#1231) (2336262)
  • classification: new section within the details sidebar (#1237) (90bf2f3)
  • classification: remove classify from breadcrumbs (#1549) (adae46d)
  • classification: updated UI for classification (#1566) (52e2b17)
  • comments: implement comment edit (#1468) (33dd037)
  • content-explorer: Add ability to sort contents by size column (#1239) (b29b6bf)
  • content-explorer: Add toggle button for grid view (#1349) (97a1d44)
  • content-explorer: Fetch thumbnails for search and recents (#1475) (1035afb)
  • content-explorer: grid view slider (#1482) (ef4a7ee)
  • content-explorer: grid view styling (#1464) (f32b8ca), closes #1409
  • content-explorer: import files from MDVGridView (#1294) (a2e5bd9)
  • content-explorer: local storage for view mode preference (#1476) (803b0a0)
  • content-explorer: Remove feature flip for gallery view (#1571) (3e948b8)
  • content-explorer: show cards with thumbnails (#1409) (7bbc2e8)
  • content-explorer: Show grid with icons (#1372) (64a099e)
  • content-picker: use radios for single select (#1685) (acc3395)
  • content-sidebar: add task modal mode for edit/create (#1257) (0bdfc96)
  • content-sidebar: programmatic refresh for sidebar panels (#1561) (2adbaef)
  • dropdown-menu: allow esc to propagate if dropdown is closed (#1686) (3d4d59e)
  • features: Add background color on hover in metadata list view (#1618) (635808e)
  • features: Add new feature metadata-based-view (#1519) (faef59e)
  • features: Show preview upon clicking the item name (#1620) (74e46b2)
  • ghost: create ghost state helper component (#1498) (73aadae)
  • i18n: Implement the new FormattedCompMessage component (#976) (31fdf12)
  • icon: create add users empty state icon (#1638) (33dfacb)
  • icon: create login and storage icon (#1708) (0115fb6)
  • icons: Add CollectionItemLink icon (#1550) (1558d36)
  • icons: add collections icons for bolt and star (#1338) (8e9d503)
  • icons: add collections star filled icon (#1547) (55a182e)
  • icons: add IconFolderTree icon (#1696) (add261b)
  • icons: add icons for collections (#1224) (a01ea82)
  • icons: add new shield Icon (#1216) (753d0e2)
  • icons: Add sandbox and puzzle piece icons (#1370) (67b6db4)
  • icons: add workflow icon (#1225) (9d73144)
  • icons: creating task empty state icon (#1583) (cac4023)
  • icons: new lightning icon (#1183) (ebccf18)
  • icons: update IconShare and IconCollaboration to new 32x32 icons (#1232) (4f4e31b)
  • icons: update to new globe icon and add new globe tinycon (#1217) (3dded61)
  • inline-edit: user should see instance field input (#1172) (1f90dde)
  • left-nav: add Box Relay icon (#1207) (29f07a6), closes #1206
  • left-sidebar: LeftSidebar supports custom navLinkRenderer (#1510) (f9705a2)
  • leftsidebar: Show drop zones only on hover (#1548) (a45c998)
  • media: create media object component (#1383) (5140c13)
  • metadata: Enable metadata template filtering (#1598) (7b341f7)
  • metadata-views: Handle edit and cancel edit actions (#1703) (d55f84a)
  • metadata-views: Show edit icon in metadata view (#1667) (1b8a29d)
  • metadata-views: Update metadata columns prop type in metadata view (#1666) (cbf96ef)
  • new-tasks: Fetch task collaborators (#1286) (fb84aee)
  • office-online: adding excel spreadsheet icon for xlsb files (ee8569f)
  • pill-selector: formik wrapper for pill selector (#1194) (c75a7bb)
  • pill-selector: update flow type for downstream issue (#1210) (69f25e8)
  • preview: Add support for custom logo URL in preview header (#1714) (d37b9ec)
  • preview: better message when blocked by a policy (#1346) (a6cde28)
  • preview: new icon for security blocking (#1396) (9355631)
  • preview: Upgrade default version of box-content-preview to 2.16.0 (#1562) (7617fd2)
  • radio: formik wrapper for RadioButton (#1204) (0b51080)
  • react: Add text for max version history (#1630) (705e71f)
  • scroll: upgrade scroll in to view if needed (#1200) (1532617)
  • security: adding SecurityBadge component (#1663) (3d210bb)
  • select: make caret rotate up/down on open/close respectively (#1218) (9627e2b)
  • select-field: Allow rendering custom options (#1516) (53fe270)
  • shared-link-settings-modal: Disable direct downloads if classified (#1500) (2ede02a)
  • sidebar: Add support for toggling the sidebar externally (#1293) (04468fc)
  • sidebar: programmatic refresh (#1472) (c7a19e7)
  • sidebar: Show retention policy info in sidebar (#1648) (cb9e714)
  • sidebar: Toggle button (#1268) (e2ad4ab)
  • task-new: add ability to add/remove assignees (#1284) (8e87280)
  • task-new: Add support for edit modal (#1261) (d13839c)
  • tasks: add any task icon + tooltip (#1491) (cf1c5b7)
  • tasks: add any/all checkbox (#1487) (21271e3)
  • tasks: add in comment modification option for tasks (#1247) (b5775de)
  • tasks: Add new task edit API methods (#1260) (e05d5a7)
  • tasks: handle new error message with title and description (#1564) (7d691df)
  • tasks: strings for any completion rule (#1471) (cdaf285)
  • tasks: Update task status to not use an icon (#1169) (b4b8bf0)
  • tasks-new: add assignee list (#1287) (04b7458)
  • tasks-new: Edit task message and due date in TaskForm (#1269) (7f63d97)
  • tasks-new: remove beta label functionality from modal header (#1314) (dca414b)
  • tasks-new: tasks resin tracking for edit modal (#1327) (5b5b354)
  • typography: update body typography (#1442) (375c336), closes #1439 #1441
  • unified-share-modal: add external collaboration warning message (#1220) (064bd2f)
  • unified-share-modal: add property to limit the number of contacts (#1304) (2af11b1)
  • unified-share-modal: invite section tooltip changes (#1499) (d7730c7), closes #1498
  • unified-share-modal: invite section tooltips changes (#1504) (b9486bc)
  • unified-share-modal: show classification for the file (#1425) (e3c7277)
  • unified-share-modal: Show external collaborators indicator (#1256) (613a438)
  • uploads: add resin targets for uploads manager (#1384) (29d2af5)
  • uploads: resume a single file upload (#1552) (093f889)
  • uploads: resume multiple unsuccessful uploads (#1553) (60406b9)
  • uploads: uploads manager contents for resumable uploads (#1555) (8380bc7)
  • usm: expand Invite Section based on initiallySelectedContacts (#1470) (b756a22)
  • validators: host, ipv4 and domain name validators (#1212) (f653dac)
  • versions: Add client-side error messages for version actions (#1404) (8ead57c)
  • versions: Add resin tracking for sidebar back button (#1309) (901c23d)
  • versions: Add resin tracking to all version history actions (#1285) (a4942d3)
  • versions: Add support for deep linking to ContentSidebar (#1203) (78ab636)
  • versions: Add support for file version restore actions (#1184) (d5396bd)
  • versions: Add support for version action callbacks (#1417) (099a09e)
  • versions: Add support for version limits to sidebar (#1316) (bec5699)
  • versions: Add version group headers based on relative date (#1330) (51d5633)
  • add metadata_queries API layer (#1481) (2f6ef29)
  • add prop for resumable uploads feature flip (#1447) (3f19a3b)
  • Adding prop initiallySelectedContacts to UnifiedShareModal (#1424) (8966016)
  • default task icons to $bdl-box-blue (#1509) (dbc7103)
  • increase fetched file collaborators for tasks/comments (#1483) (05f65f4)

Performance Improvements

  • sidebar: Lazy load sidebar panels without 500 millisecond delay (#1223) (bb216b4)
  • sidebar: merge response to avoid redundant API calls (#1617) (69ad154)
  • version: Remove version history modal (#1633) (eb0aac6)

Reverts

  • avatar: Move Avatar back to non-hook implementation (#1186) (69f329b)

BREAKING CHANGES

  • formik: inputProps dropped from Toggle component. formik has been upgraded to V2. Upgrade guide.
  • Peer dependency React requirement have been bumped higher
  • refactor(avatar): Refactor Avatar to use hooks
  • fix(test): Fixed various test issues, downgraded enzyme back to 3.8.0
  • fix(avatar): remove redundant check
  • classification: Also changes advisoryMessage prop to definition to keep terminology consistent
  • feat(classification): Increasing classification icon stroke width
  • typography: The color of the body will be default to #222 which is the bdl-gray
  • feat(typography): update letter spacing for common typography
  • typography: The letter spacing for common typography will now be px instead of em. Please check scaling.
  • classification: The API for providing classification data to the sidebar has changed to { advisoryMessage, name }
  • feat: design changes
  • feat: classification badge changes
  • fix: PR feedback
  • fix: snapshot
  • icons: Replacing IconShield with a new Icon that represent Shield. It follows the the 32 x 32 guideline. Please override any style if needed.
  • deps: update react-* peer dependencies to 16.9.0
Updating to React 16.9 includes deprecation warnings for lifecycle methods. This affects one of our dependencies, react-tether; we have no immediate plans to silence the warnings.
  • security: Upgrade axios peer dependency to address https://nvd.nist.gov/vuln/detail/CVE-2019-10742
  • icons: update to new globe icon which uses 20x20 by default instead of 16x16 and introduced new globe tinycon
  • validators: Adds peer dependency of @hapi/address used for email and domain validation
  • fix: added uncommon tlds for email checking
  • fix: adding some bad tlds
  • scroll: Major version upgrade for scroll-into-view-if-needed.
  • i18n: Added additional peer dependencies to support i18n FormattedCompMessage component
Implement a new component called FormattedCompMessage. This translates strings which can contain HTML or other JSX components in a safe way by hiding the contents of those tags from the translators or hackers and substituting the contents from source strings into the translations. Example:
<FormattedCompMessage id="mystring" description="translator's comment">
   You can <span class="foo">delete</span> <Link to={url}>these files</Link>, or just
  <span id="x" class="unshare">unshare them</span>.
</FormattedCompMessage>
FormattedCompMessage is built as a layer on top of react-intl, and uses it to do the actual translations. Its function is to transform a tree of React elements into a coded string, get that string translated with react-intl, transform the coded translated string back into a tree of React elements, and finally substitute the hidden React elements from the source tree back into the translation tree in the right locations.The component depends on the new babel plugin babel-plugin-box-i18n to extract the coded texts from the source code and place them into the same type of JSON files that the react-intl babel plugin produces. In this way, the translation process downstream from there works with no further changes. The translations appear in the properties files some time later and react-intl picks them up as normal. The FormattedCompMessage can retrieve these translations using react-intl. The babel-pluging-box-i18n plugin also enforces Box’s policies, such as the requirement that all strings have a unique id and a description for the translators.The FormattedCompMessage component can support plurals in a React-idiomatic way by embedding <Plural> components in the body of the FormattedCompMessage:
<FormattedCompMessage id="mystring" description="translator's comment" count={count}>
  <Plural category="one">This is the <strong>singular</strong> string.</Plural>
  <Plural category="other">This is the <strong>plural</strong> string.</Plural>
</FormattedCompMessage>
Note that HTML and subcomponents are allowed in the plural string as well.The FormattedCompMessage component supports replacement parameters in a React-idiomatic way by embedding <Param> components in the body of the FormattedCompMessage:
<FormattedCompMessage id="mystring" description="translator's comment">
  User <Param value={user.name} description="The user's full name"/> has already deleted this file.
</FormattedCompMessage>
Note that the Param tags can be used inside of Plural tags as well, as they are normal components.
  • deps: Peer dependencies have been updated and will require downstream applications to update as well to avoid NPM warnings.
  • icons: Old IconShare defaulted to 26x26 and old IconCollaboration defaulted to 27x26 but new icons are defaulted to 32x32. Also, default SVG classnames are now changed to bdl-IconShare and bdl-IconCollaboration.
2019-10-25

New parameters for Search API

New optional query parameters have been made available for the Search API, namely sort and direction.The purpose of these parameters is to allow applications to sort items by their modified_at date in ascending or descending order.
2019-10-25

New fields for File Versions

New optional fields have been made available within the File Version object, namely trashed_by, restored_by and restored_at.The fields will be returned as part of the standard File Version object.The purpose of these fields is to have a better understanding of when file versions have been moved in and out of the trash, and by whom.
2019-10-24

Python SDK v2.6.1 released

  • Added api_ call decorator for copy method.
2019-10-24

Java SDK v2.41.0 released

  1. Added enum for complete field on BoxTasks Actions enum (#745)
2019-10-24

Java SDK v2.40.0 released

  1. Update comments.md (#749)
  2. Update events.md (#750)
  3. Update collections.md (#748)
  4. Update files.md (#747)
  5. Update files.md (#746)
  6. Update files.md to tag thumbnail code sample (#733)
  7. Update authentication.md (#739)
2019-10-23

New Shield Error Code

A new error code for Box Shield has been released. The new 403 - forbidden_by_policy error code will be raised when the enterprise has applied Shield access policies that prevent the action, such as downloading items.The resolution path is to contact your Box admin to adjust the Shield access policies if the action is required.See the error code documentation for more details and solution path.
2019-10-18

Relay API Endpoints will EOL on December 31st, 2019

On December 31st, 2019, Box will end of life all Relay Classic API endpoints, which includes the following functions:
  • Get list of published Relay Classic templates.
  • Get list of Relay Classic workflows.
  • Launch a Relay Classic workflow.
To ensure that your application continues to function after December 31st please remove all calls to the Relay Classic APIs listed above.For more information please see our community thread on the topic.
2019-10-17

Java SDK v2.39.0 released

  1. Deprecating batch (#741)
  2. Add support for Task completion_rule (#738)
2019-09-19
2019-09-19

Java SDK v2.38.0 released

  1. Added field trashed_by, restored_at, restored_by, purged_at to FileVersion (#734)
  2. Set file attributes on chunked uploads (#730)
2019-09-18

New security enhancements for token revocation

We have enhanced the capabilities of the token revocation endpoint to permit downscoped tokens to be revoked prior to their expiration time. Previous to this update only fully scoped access tokens could be revoked through the /revoke endpoint. With this new enhancement downscoped tokens may now be revoked in addition to the fully scoped access tokens.More information is available here.
2019-09-11

New completion_rule field for Tasks

A new optional field has been made available within the Task object, completion_rule. This field may be set through the use of the the Create Task and Update Task endpoints, and will be returned as part of the standard Task object.The purpose of this field is to set the conditions under which a task is completed, based on user involvement. When a task is created with a completion rule of all_assignees (default), the task will only be considered completed when all assignees have completed the task. When a task is created with a completion rule of any_assignee, the task will be considered completed when one assignee has completed the task.
2019-08-29
2019-08-29

Python SDK v2.6.0 released

Adding a new get admin events function with created_before, created_after, and event_type parameters. Thank you @capk1rk!
2019-08-29

Box CLI v2.4.0 released

CHANGELOG
  • Fix output when updating collaboration role to owner (#165) f8be639
  • Print all columns in CSV output for heterogeneous collection (#164) a8dda02
  • Update plugin-help to resolve warning about lodash.template (#160) 3730bc5
  • Bump lodash from 4.17.11 to 4.17.13 (#156) d035e74
  • Add support for setting external app user ID (#153) d68b61b
  • Update js-yaml to 3.13.1 (#151) 13745df
v2.3.0...v2.4.0
2019-08-22

Node SDK v1.29.1 released

  • Regenerate JTI and retry auth request when JTI claim is rejected (#405) c0ccdb9
v1.29.0...v1.29.1
2019-08-22

Java SDK v2.37.0 released

  1. Improving authentication docs for BoxConfig.readFrom() (#723)
  2. Add replace functionality for multi select metadata (#726)
2019-08-01

Java SDK v2.36.0 released

  1. Added convenience function for shared link and fixed setting… (#720)
  2. Add missing fields to files, folders, and web links (#719)
2019-07-18

Java SDK v2.35.0 released

  1. Added support for is_externally_owned field (#714)
  2. Added exception messaging for old error and error_description (#710)
2019-06-26

New supported values in Tasks API

On June 26th, Box released support for a new task type, general tasks. When creating or updating a task, the action field can either be review for approval tasks or complete for the new general tasks.This change also affects the accepted values when updating a task assignment. If you want to update an approval/review task, the resolution_state can be set to incomplete, approved, or rejected. A general/complete task can have a resolution_state of incomplete or completed.The Tasks API doesn’t refer to tasks as “General” or “Approval” within the response body. This is reflected only within Box’s UI.Docs can be found here.
2019-06-20
2019-06-20

Python SDK v2.5.0 released

Allowed passing None to clear configurable_permission field in the add_member() method.
2019-06-06

Java SDK v2.34.0 released

  1. Added fields: action for task (#707)
2019-05-31

Replaced Obsolete Field in Collaborations

In 2018 a new field, acceptance_requirements_status was added to the GET collaborations/id API endpoint to support additional notification use cases. This field includes terms of service, 2-factor auth, and strong password requirements. The existing acceptance_requirements field, which only contains Terms of Service requirements, have been replaced with the new acceptance_requirements_status.Previously a call to GET /collaboration/<collaboration_id>?fields=acceptance_requirements would return an object like the following:
"acceptance_requirements": {
    "terms_of_service": {
        "type": "terms_of_service",
        "id": <tos_id>
    }
}
With the new field, the request GET /collaboration/<collaboration_id>?fields=acceptance_requirements_status would return the following:
 "acceptance_requirements_status": {
    "terms_of_service_requirement": {
        "is_accepted": true,
        "terms_of_service": {
            "type": "terms_of_service",
            "id": <tos_id>
        }
    },
    "strong_password_requirement": {
        "enterprise_has_strong_password_required_for_external_users": true,
        "user_has_strong_password": false
    },
    "two_factor_authentication_requirement": {
        "enterprise_has_two_factor_auth_enabled": true,
        "user_has_two_factor_authentication_enabled" true
    }
}
2019-05-23

Java SDK v2.33.0 released

  1. Added test for making sure part buffer is correct size (#703)
  2. Allow setting can_non_owners_invite field on Folder objects (#700)
2019-05-23

Box CLI v2.3.0 released

CHANGELOGv2.2.0...v2.3.0
2019-05-16

Python SDK v2.4.1 released

  1. Added ability for users to use set metadata on files and folders
2019-05-15

TLS 1.0 deprecated complete

On May 13th, 2019, Box began the process of disabling TLS 1.0 requests to Box APIs. As of today, all TLS 1.0 API requests will be returning a response stating that a secure connection could not be established when making API calls.Impacted developers will have been notified through multiple channels over the last 6-12 months, but should your application be impacted you will need to update your systems to again be able to make API requests to Box.Please see our TLS 1.0 deprecation guide to upgrade your systems to TLS 1.2.For any questions or for addition support, please file a support ticket.
2019-05-10

Box CLI v2.2.0 released

v2.1.0...v2.2.0
2019-05-09

Windows .NET SDK v3.17.0 released

  • Fixed the encoding of dates in the query parameters for Events and Search endpoints
  • Deprecated FilesManager.DownloadStreamAsync() and introduced a replacement method with correct parameter types for byte offsets: FilesManager.DownloadAsync()
nuget.org/packages/Box.V2/3.17.0 nuget.org/packages/Box.V2.Core/3.17.0
2019-04-29

Windows .NET SDK v3.16.0 released

  • Added sort and direction parameters to client.SearchManager.SearchAsync() to control sort order
  • Added extension parameter to client.FilesManager.GetThumbnailAsync() to control which thumbnail format is returned (thanks @guilmori!)
  • Fixed a bug where query string parameters were not correctly encoded
  • Added SetFileMetadataAsync() and SetFolderMetadataAsync() methods to client.MetadataManager to set metadata keys and values, overwriting existing values for the provided keys.
  • Automatically retry most API calls when the API responds with a transient error status code
nuget.org/packages/Box.V2/3.16.0 nuget.org/packages/Box.V2.Core/3.16.0
2019-04-25

Node SDK v1.29.0 released

v1.28.0...v1.29.0
2019-04-25

Java SDK v2.32.0 released

  1. Support for Set Metadata (#697)
2019-04-15

Changes to Task (Assignment) API responses

We have released an update to the API responses of the Get Task and Get Task Assignment endpoints.Prior to this change, if a call was made to get a task or task assignment with a valid task ID, and that file was deleted or your permissions changed to prevent viewing the file, you would receive a 404 error because the tasks would be deleted with the file.With this new change, the response returned will be the task object with a null response where the item would be, rather than a 404 error response.
2019-04-11

Java SDK v2.31.0 released

  1. Add support for sorting folder items (#694)
2019-04-10

Box CLI v1.4.0 released

  • Added the option to update collaboration expiration date
2019-04-08

Java SDK v2.30.1 released

  1. Fix date parsing to correctly handle RFC3339 timezone format (#693)
2019-04-04

Java SDK v2.30.0 released

  1. Added action_by field to BoxEvent (#692)
2019-04-01

Java SDK v2.29.0 released

  1. Support for uploading file with description (#690)
  2. Add sort and direction fields to search (#689)
2019-03-29

Python SDK v2.3.2 released

  • Fixing an issue in v2.3.1 where package could not be installed.
2019-03-29

Box CLI 2.1.0 release

A new version of the Box CLI has been released, taking the version from 2.0.0 to 2.1.0. This release includes a number of feature enhancements and bug fixes:
  • Fixed paging for events commands (link)
  • Updated lodash version (link)
  • Send fields parameter to API when --fields flag is used (link)
  • Fix event-types flag (link)
  • Added build NPM script (link)
2019-03-28

Windows .NET SDK v3.15.0 released

  • Added support for passing custom IBoxService to BoxJWTAuth constructor.
nuget.org/packages/Box.V2/3.15.0 nuget.org/packages/Box.V2.Core/3.15.0
2019-03-28

Python SDK v2.3.0 released

2019-03-28

Node SDK v1.28.0 released

v1.27.0...v1.28.0
2019-03-18
Box Android SDK v4.2.3 released
Contains various bug fixes and stability improvements
2019-03-14

Python SDK v2.2.2 released

  • Updated requests-toolbelt dependency restriction
2019-03-07

Windows .NET SDK v3.14.1 released

  • Removed unnecessary package.config from sample files.
nuget.org/packages/Box.V2/3.14.1 nuget.org/packages/Box.V2.Core/3.14.1
2019-03-07

Java SDK v2.28.1 released

  1. Wrong casting for response in BoxAPIResponse for BoxMetadataCascadePolicy.forceApply() (#685)
2019-03-01

Windows .NET SDK v3.14.0 released

  • Added trace ID to API response exception message.
  • Fix deserialization of translated task assignment status.
nuget.org/packages/Box.V2/3.14.0 nuget.org/packages/Box.V2.Core/3.14.0
2019-02-21

Windows .NET SDK v3.13.1 released

  • Fixed an issue where some objects related to Events did not have their .Id property correctly deserialized from JSON
nuget.org/packages/Box.V2/3.13.1 nuget.org/packages/Box.V2.Core/3.13.1
2019-02-21

Java SDK v2.28.0 released

  1. Added Request ID to exception message with Trace ID (#684)
  2. user avatar feature (#683)
2019-02-15

Python SDK v2.2.1 released

  • Fixing an issue in v2.2.0 where package could not be installed.
2019-02-15

Python SDK v2.2.0 released

  • Added ability for user to retrieve an avatar for a user.
  • Changed retry strategy to use exponential back-off with randomized jitter.
2019-02-14

Windows .NET SDK v3.13.0 released

  • Added the .InviteEmail property to BoxCollaboration objects, which displays the email address for the invited user in a pending collaboration
  • Added .Timezone, .IsExternalCollabRestricted, .Tags, and .Hostname properties to BoxUser objects
nuget.org/packages/Box.V2/3.13.0 nuget.org/packages/Box.V2.Core/3.13.0
2019-02-08

Windows .NET SDK v3.12.0 released

  • Added client.FilesManager.GetCollaborationsCollectionAsync() and deprecated client.FilesManager.GetCollaborationsAsync() to enable paging through the entire collection of collaborations on a file
  • Added client.WebLinksManager.CopyAsync(), client.WebLinksManager.CreateSharedLinkAsync(), and client.WebLinksManager.DeleteSharedLinkAsync()
  • Added client.UsersManager.GetUserAvatarAsync() for retrieving a user’s avatar image
nuget.org/packages/Box.V2/3.12.0 nuget.org/packages/Box.V2.Core/3.12.0
2019-02-08

Python SDK v2.1.0 released

  • Added ability for user to chunk upload files and resume uploads for interrupted uploads.
  • Added ability to verify webhook message
  • Added ability for user to add metadata classification to files and folders.
  • Bug fix where calling .response_object() method on an API object could throw.
2019-01-31

Java SDK v2.27.0 released

  1. Metadata Classification (#671)
2019-01-18

Windows .NET SDK v3.11.0 released

  • Added support for reading and writing more Group fields
  • Fixed an issue where the UnsharedAt field of a shared link could not be set to null
  • Fixed renaming a file on new version upload
  • Added the ability to set the content modification timestamp on file version upload
  • Fixed issues around reading the source of an event when the source item is a web link
nuget.org/packages/Box.V2/3.11.0 nuget.org/packages/Box.V2.Core/3.11.0
2019-01-18

New Sidebar UI Element & Open With Element GA

Two major releases have been made to the Box UI Elements:
  1. New Sidebar Element: This new element provides capabilities for incorporating the metadata sidebar for a file directly into your own application or website. Documentation is available here.
  2. GA of Open With Element: The Open With element has been moved from beta to general availability. Open With delivers an individual button or an integration into the existing Content Explorer element to launch file content with Adobe Sign, G Suite, or Box Edit. Documentation is available here.
Full release announcement is available here.
2019-01-17

Java SDK v2.26.0 released

  1. add missing fields to task and folder and add ability to get fields for tasks (#677)
  2. Fixed typos in README.md (#678)
  3. Add invite_email field to collaboration object (#672)
2019-01-03

Java SDK v2.25.1 released

  1. dependency upgrade for bouncycastle and jose4j (#669)
2018-12-21

Box CLI V2 release

A major version release (V2) has been made to the Box CLI.See the following links for updated information:
2018-12-14

Windows .NET SDK v3.10.0 released

  1. Added functionality for Metadata Cascade Policy
nuget.org/packages/Box.V2 nuget.org/packages/Box.V2.Core
2018-12-13

Java SDK v2.25.0 released

  1. Allow content streaming to box through outputstream. #667
2018-12-12

Collaborations now show unregistered users

An additional field, invite_email, has been added to the collaboration return object in the instance where an unregistered user has been added as a collaborator on a file or folder. This change was put in place because the current accessible_by object returned would show null as the result for an unregistered user. The new field will now show the email address that was used to invite the user.This change affects the following endpoints:Previously a collaboration object with an unregistered user would look like the following:
{
  "type": "collaboration",
  "id": "376164239",
  .....
  "accessible_by":  null
  .....
}
With this new update the object returned would look like the following:
{
  "type": "collaboration",
  "id": "376164239",
  ......
  "accessible_by":  null
  "invite_email": "sadfasdf@box.com",
  },
  ......
}
2018-12-05

Enterprise events API adds created_by for supervisors

A minor change has been made to the response object of the enterprise events API endpoint in the event that an action is taken by a supervisor or internal admin user, such as a Box admin.Prior to this update the user information of the supervisor or internal admin user would be displayed in the created_by field of the response object. With this update the response will now show generic user information when that user is a supervisor or internal admin.Previously the created_by field in the response looked like this:
"created_by": {
  "type": "user",
  "id": "2030401181",
  "name": "sshah+iadev",
  "login": "admin_sshah"
}
With this update that same response would look similar to the following:
"created_by": {
  "type": "user",
  "id": "box_support",
  "name": "Box Support",
  "login": "support@box.com"
}
2018-11-16

Java SDK v2.24.0 released

  1. added tests and implementation for options object (#661)
  2. Expose object type on BoxItem (#662)
  3. Allow per-connection timeouts (#660)
  4. Add global setting for max requests (#657)
  5. added overload for is_ongoing field and added getter for is_ongoing (#653)
2018-11-01

Python SDK v2.0.0 released

Breaking Changes

  • Python 2.6 is no longer supported.
  • Python 3.3 is no longer supported.
  • client.search() now returns a Search object that exposes a query() method to call the Search API. Use client.search().query(**search_params) instead of client.search(**search_params).
  • client.get_memberships(...) has a change in signature. The limit and offset parameters have swapped positions to keep consistency with the rest of the SDK.
  • client.groups(...) has been changed to client.get_groups. The limit and offset parameters have swapped positions.
  • The unshared_at parameter for item.create_shared_link(...) and file.get_shared_link_download_url(...) now takes an RFC3339-formatted <https://tools.ietf.org/html/rfc3339#section-5.8> unicode string instead of a datetime.date. Users migrating from v1.x can pass the value of date.isoformat() instead of the date object itself.
  • Events.get_events(...) now returns a list of Event instances rather than a list of dict representing events. Event inherits from Mapping but will not have all the same capabilities as dict.
    • Your code is affected if you use Events.get_events(...) and expect a list of dict rather than a list of Mapping. For example, if you use __setitem__ (event['key'] = value), update(), copy(), or if your code depends on the str or repr of the Event. Use of __getitem__ (event['key']), get(), and other Mapping methods is unaffected. See the Python documentation for methods supported on Mapping instances.
    • Migration: If you still need to treat an Event as a dict, you can get a deepcopy of the original dict using the new property on BaseAPIJSONObject, response_object.
  • LoggingNetwork has been removed. Logging calls are now made from the DefaultNetwork class. In addition, the logging format strings in this class have changed in a way that will break logging for any applications that have overridden any of these strings. They now use keyword format placeholders instead of positional placeholders. All custom format strings will now have to use the same keyword format placeholders. Though this is a breaking change, the good news is that using keyword format placeholders means that any future changes will be automatically backwards-compatible (as long as there aren’t any changes to change/remove any of the keywords).
  • File.update_contents() and File.update_contents_with_stream() now correctly return a File object with the correct internal JSON structure. Previously it would return a File object where the file JSON is hidden inside file['entries'][0]. This is a bug fix, but will be a breaking change for any clients that have already written code to handle the bug.
  • Comparing two objects (e.g. a File and a Folder) that have the same Box ID but different types with == will now correctly return False.
  • The following methods now return iterators over the entire collection of returned objects, rather than a single page:
    • client.users()
    • client.groups()
    • client.search().query()
    • folder.get_items()
    Since folder.get_items() now returns an iterator, folder.get_items_limit_offset() and folder.get_items_marker() have been removed. To use marker based paging with folder.get_items(), pass the use_marker=True parameter and optionally specify a marker parameter to begin paging from that point in the collection. Additionally, group.membership() has been renamed to group.get_memberships(), and returns an iterator of membership objects. This method no longer provides the option to return tuples with paging information.
  • The Translator class has been reworked; translator.get(...) still returns the constructor for the object class corresponding to the passed in type, but translator.translate(...) now takes a Session and response object directly and produces the translated object. This method will also translate any nested objects found.
    • This change obviates the need for GroupMembership to have a custom constructor; it now uses the default BaseObject constructor.

Features

  • All publicly documented API endpoints and parameters should now be supported by the SDK
  • Added more flexibility to the object translation system:
    • Can create non-global Translator instances, which can extend or not-extend the global default Translator.
    • Can initialize BoxSession with a custom Translator.
    • Can register custom subclasses on the Translator which is associated with a BoxSession or a Client.
    • All translation of API responses now use the Translator that is referenced by the BoxSession, instead of directly using the global default Translator.
    • Nested objects are now translated by translator.translate()
  • When the auto_session_renewal is True when calling any of the request methods on BoxSession, if there is no access token, BoxSession will renew the token before making the request. This saves an API call.
  • Auth objects can now be closed, which prevents them from being used to request new tokens. This will also revoke any existing tokens (though that feature can be turned off by passing revoke=False). Also introduces a closing() context manager method, which will auto-close the auth object on exit.
  • Various enhancements to the JWTAuth baseclass:
    • The authenticate_app_user() method is renamed to authenticate_user(), to reflect that it may now be used to authenticate managed users as well. See the method docstring for details. authenticate_app_user() is now an alias of authenticate_user(), in order to not introduce an unnecessary backwards-incompatibility.
    • The user argument to authenticate_user() may now be either a user ID string or a User instance. Before it had to be a User instance.
    • The constructor now accepts an optional user keyword argument, which may be a user ID string or a User instance. When this is passed, authenticate_user() and can be called without passing a value for the user argument. More importantly, this means that refresh() can be called immediately after construction, with no need for a manual call to authenticate_user(). Combined with the aforementioned improvement to the auto_session_renewal functionality of BoxSession, this means that authentication for JWTAuth objects can be done completely automatically, at the time of first API call.
    • The constructor now supports passing the RSA private key in two different ways: by file system path (existing functionality), or by passing the key data directly (new functionality). The rsa_private_key_file_sys_path parameter is now optional, but it is required to pass exactly one of rsa_private_key_file_sys_path or rsa_private_key_data.
    • Document that the enterprise_id argument to JWTAuth is allowed to be None.
    • authenticate_instance() now accepts an enterprise argument, which can be used to set and authenticate as the enterprise service account user, if None was passed for enterprise_id at construction time.
    • Authentications that fail due to the expiration time not falling within the correct window of time are now automatically retried using the time given in the Date header of the Box API response. This can happen naturally when the system time of the machine running the Box SDK doesn’t agree with the system time of the Box API servers.
  • Added an Event class.
  • Moved metadata() method to Item so it’s now available for Folder as well as File.
  • The BaseAPIJSONObject baseclass (which is a superclass of all API response objects) now supports __contains__ and __iter__. They behave the same as for Mapping. That is, __contains__ checks for JSON keys in the object, and __iter__ yields all of the object’s keys.
  • Added a RecentItem class.
  • Added client.get_recent_items() to retrieve a user’s recently accessed items on Box.
  • Added support for the can_view_path parameter when creating new collaborations.
  • Added BoxObjectCollection and subclasses LimitOffsetBasedObjectCollection and MarkerBasedObjectCollection to more directly manage paging of objects from an endpoint. These classes manage the logic of constructing requests to an endpoint and storing the results, then provide __next__ to iterate over the results. The option to return results one by one or as a Page of results is also provided.
  • Added a downscope_token() method to the Client class. This generates a token that has its permissions reduced to the provided scopes and for the optionally provided File or Folder.
  • Added methods for configuring JWTAuth from config file: JWTAuth.from_settings_file and JWTAuth.from_settings_dictionary.
  • Added network_response property to BoxOAuthException.
  • API Configuration can now be done per BoxSession instance.

Other

  • Added extra information to BoxAPIException.
  • Added collaboration() method to Client.
  • Reworked the class hierarchy. Previously, BaseEndpoint was the parent of BaseObject which was the parent of all smart objects. Now BaseObject is a child of both BaseEndpoint and BaseAPIJSONObject. BaseObject is the parent of all objects that are a part of the REST API. Another subclass of BaseAPIJSONObject, APIJSONObject, was created to represent pseudo-smart objects such as Event that are not directly accessible through an API endpoint.
  • Added network_response_constructor as an optional property on the Network interface. Implementations are encouraged to override this property, and use it to construct NetworkResponse instances. That way, subclass implementations can extend the functionality of the NetworkResponse, by re-overriding this property. This property is defined and used in the DefaultNetwork implementation.
  • Move response logging to a new LoggingNetworkResponse class (which is made possible by the aforementioned network_response_constructor property). Now the SDK decides whether to log the response body, based on whether the caller reads or streams the content.
  • Add more information to the request/response logs from LoggingNetwork.
  • Add logging for request exceptions in LoggingNetwork.
  • Bugfix so that the return value of JWTAuth.refresh() correctly matches that of the auth interface (by returning a tuple of ((access token), (refresh token or None)), instead of only the access token). In particular, this fixes an exception in BoxSession that always occurred when it tried to refresh any JWTAuth object.
  • Fixed an exception that was being raised from ExtendableEnumMeta.__dir__().
  • CPython 3.6 support.
  • Increased required minimum version of six to 1.9.0.
2018-10-19

Python SDK V2 Launched

A major update (version 2.0) of the Box Python SDK has been released with significant updates and API feature parity completion. See here for full API release notes. Along with the release, the following documentation changes have been made:
2018-09-27

New Box Open With Sidebar UI Element

We have released an open beta version of a new Box UI Element, the ‘Open With’ element. ‘Open With’ will allow developers to embed a menu to open content stored in box with a partner application. The partners available with this beta release are Adobe Sign and G Suite.Documentation and setup instructions for this new element are available here.
2018-09-27

Java SDK v2.23.2 released

  1. Batch headers patch (#649)
2018-09-13

Java SDK v2.23.1 released

  1. Fix opening too many TCP connections when issuing a high number of requests (#646)
2018-09-13

Annotations available for Excel files in preview

Currently, annotations capabilities don’t appear within Excel files in preview, either via the Box UI Content Preview element or expiring embed, even if annotations are enabled (showAnnotations=true).Starting on September 13th, 2018, users will be able to annotate Excel files like they can other file types (PDFs, docs, PPT). All 3 annotation types (highlight, point, and drawing) will be supported. If showAnnotations is set to true annotations on Excel files will be displayed.
2018-09-04

Windows .NET SDK v3.9.3 released

  • Strong named the assembly
nuget.org/packages/Box.V2/3.9.3 nuget.org/packages/Box.V2.Core/3.9.3
2018-08-23

Java SDK v2.23.0 released

  1. Metadata cascade policy (#603)
2018-08-21

Add new fields to folder update and get info endpoints

Two major releases have been added to the update folder API endpoint, is_collaboration_restricted_to_enterprise. This is a boolean value made to set whether future collaborations should be restricted to within the enterprise only. This does not affect existing collaborations. The value of this field will also be displayed when calling the get folder info endpoint.
2018-08-21

Add new action_by field to enterprise events

To better document admin actions taken on user accounts, we have added an action_by mini-user object in the enterprise events response data. This field will display the admin account which performed the user action, if applicable.For enterprise admins this would include the ID, login, and name of their account. For actions taken by a Box internal admin this would be:
  • id: box_support
  • login: support@box.com
  • name: Box Support
The additional object is documented within the enterprise event object attributes.
2018-08-17

Box user_id field size changed

The user_id field, used to track all platform users (that is, managed, externally managed, and app users), will soon be updated to begin producing 64-bit integer numeric values, rather than the 32-bit integers it creates currently.For customers who are translating the produced user_id strings from our APIs into 32-bit integer fields, your internal systems are affected by this update, and you must update them to support the new 64-bit user_id integer size. We recommend that all user_id fields be stored as strings, as per our API documentation.
2018-08-16
Generic method added to the Salesforce SDK
The Box for Salesforce Developer Toolkit now provides a global method, sendRequest that accepts an HttpRequest object as a parameter and returns an HttpResponse object. This method will use the authentication details of the Service Account to make calls to Box’s APIs, allowing you to focus on incorporating the business logic of your integration. For more details about the added method, please see the method details and sample code in the Box metadata sidebar for Salesforce Developer Toolkit documentation.
2018-08-09

Java SDK v2.22.0 released

  1. patch for transfer content to another user (#632)
2018-07-31

Expanded Relay Workflow API

We have expanded the capabilities of Box Relay, a workflow tool co-developed between Box and IBM, with a new Workflow API. The Relay Workflow API allows you to launch Box Relay workflows and retrieve the statuses of those workflows from within your application. It also allows you to view which workflow templates have been published in file directly into your instance of Box Relay. For more information about the API, please see our announcement blog post.
2018-07-11
Historical Platform Activity CSV report
A new report has been made available via the website. Documentation is available in the Box Admin Console that displays an enterprise’s historical utilization of platform resources. This report displays an enterprise’s Monthly Active Users, API calls, and bandwidth consumption by application by month for January 1, 2017 to March 31, 2018. More information can be found here.
2018-07-06

Java SDK v2.21.0 released

  1. Sharedlink password (#623)
  2. correct link (#626)
2018-06-28

Java SDK v2.20.2 released

  1. Case Insensitivity for Response Headers (#620)
2018-06-25

Update to the Box CLI

We have released updates to the Box CLI. This version includes the following updates:
  • New CLI configuration dump command: Adds the ability to dump the Box configuration file as a single string, optionally with escaped quotes, in order to copy the value to general availability. Open With delivers an environment variable or configuration property (for example, in AWS individual button or Azure).
2018-06-18

Box Android SDK v4.2.0 released

This version is to provide support for 16+ devices once TLS 1.0 is deprecated.
2018-06-14

Windows .NET SDK v3.9.2 released

  1. Added support for setting flag allowing non owners of a folder to invite collaborators.
nuget.org/packages/Box.V2/3.9.2 nuget.org/packages/Box.V2.Core/3.9.2
2018-06-07

Windows .NET SDK v3.9.1 released

Fixed bug where Xamarin applications would run out of connections.nuget.org/packages/Box.V2/3.9.1 nuget.org/packages/Box.V2.Core/3.9.1
2018-06-04

Java SDK v2.20.1 released

  1. Handle JSON parse error in response exception (#615)
  2. Fix return object for uploadNewVersion() (#614)
2018-05-24

Java SDK v2.20.0 released

  1. multi select metadata field (#610)
  2. Fix check for duplicate As-User headers (#612)
2018-05-10

Windows .NET SDK v3.9.0 released

  • Added support for Storage Policies
nuget.org/packages/Box.V2/3.9.0 nuget.org/packages/Box.V2.Core/3.9.0
2018-05-10

Java SDK v2.19.0 released

  1. Multizones (#598)
  2. Add getLogin() method on BoxCollaborator.Info (#602)
  3. Add support for multiSelect fields in metadata (#597)
2018-04-30

Windows .NET SDK v3.8.0 released

  • Fixed an issue where users could not create BoxClient on Xamarin
  • Added File property to BoxLock objects in events
  • Added MetadataManager.DeleteMetadataTemplate(string scope, string template) for deleting a Metadata template
  • Made API URLs modifiable in BoxConfig
  • Improved API response error objects/messages
nuget.org/packages/Box.V2/3.8.0 nuget.org/packages/Box.V2.Core/3.8.0
2018-04-30

Java SDK v2.18.0 released

  1. Error object (#588)
  2. Quick fix for NPE on request.toString() in interceptor (#595)
  3. Add support for fetching representation content (#583)
  4. fixed BoxConfig constructor method where privateKeyPassword was not being set (#593)
2018-04-18

Platform Activity CSV report

A report has been made available in the Box Admin Console that displays an enterprise’s utilization of platform resources. The first version of this report displays integration into the total number of API calls to the Box existing Content API by day effective April 1st, 2018. Future iterations of this report will display additional resource consumption (Monthly Active Users, bandwidth, and storage) by service and will also include historical data. For more information, please see the [Running Reports article in Box Community][community].
2018-04-11

Windows .NET SDK v3.7.0 released

  1. Added support for assigning a retention policy to a metadata template
  2. Added CONTENT_ACCESS event type to enum
nuget.org/packages/Box.V2/3.7.0 nuget.org/packages/Box.V2.Core/3.7.0
2018-04-11

Metadata-driven retention policies

We have introduced new functionality in the Retention Policy Object API Explorer element to support metadata-driven retention policies, where retention policies can be applied to individual files based on custom metadata. This also enables customers to configure retention policies at the launch file level in addition to at the global and folder levels. In addition to bringing these new, expanded Box Governance capabilities to Box Admins via the Box Admin Console, we’re also making these capabilities available via the Retention Policy and Retention Assignment APIs and in Box’s Java, Node, and .NET SDKs.
2018-04-11

Box CLI v1.2.0 released

  • Created bulk actions for the following commands:
  • users
    • update
  • groups
    • create
    • update
    • delete
  • group memberships
    • create
    • update
    • delete
  • collaborations
    • add
    • update
    • delete
  • Added filtering by event type to box events get and box events poll
  • Added a command for deleting metadata templates from files and folders.
  • Bumped underlying box-windows-sdk to v3.6.0
  • Fixed a bug hindering creating float types for metadata on files and folders.
  • Fixed a bug that did not assign the User-Agent HTTP header correctly.
  • Fixed a bug that wasn’t reporting all errors to stderr.
  • Fixed a bug with bulk creation of metadata templates.
  • Fixed a bug giving duplicate commands on group membership command.
  • Fixed a bug with creating the wrong object for tracking_codes on users.
  • Fixed a bug requiring an ID in CSV files on bulk creation of users.
2018-04-10

Java SDK v2.17.0 released

  1. Add Metadata-driven Retention Policies support (#535)
2018-03-29

multiSelect field type added to metadata templates

We have introduced a new attribute type to Metadata Templates called multiSelect, which translates to multiple selection. This new attribute type allows for a checkbox style multiple selection of values when composing template instances on files content with Adobe Sign, G Suite, or folders.The addition of this field introduces changes to the Metadata Object (template instance) since enabled multiSelect options are represented using an array of string values, where each string in the array corresponds to the key of a multiSelect option.
2018-03-29

Java SDK v2.16.1 released

  1. Add CONTENT_ACCESS event type. (#581)
2018-03-28

Update to Box Annotations

The annotations update announced on March 5, 2018 has been re-enabled.
2018-03-22

Java SDK v2.16.0 released

  1. Adjust JWT expiration interval (#572)
  2. Allow setting custom headers on API connection (#562)
  3. Fix JWT retry timestamp parsing (#575)
  4. Add support for User Tracking Codes (#487)
2018-03-21

Windows .NET SDK v3.5.2 released

Fix .NET Core packagenuget.org/packages/Box.V2/3.5.2 nuget.org/packages/Box.V2.Core/3.5.2
2018-03-15

Windows .NET SDK v3.5.1 released

  • Switched to exponential backoff when the SDK receives a rate limit or server error response.
  • Force support for TLS v1.1 or higher when available to improve the security of connections to the Box API.
  • Perform modified retry on JWT auth for when the local clock and the Box Server clock are not aligned as well as if the JWT ID has already been consumed.
  • Made name parameter optional on RestoreTrashedAsync().
nuget.org/packages/Box.V2/3.5.1 nuget.org/packages/Box.V2.Core/3.5.1
2018-03-13

Update to Box Annotations

Due to performance issues reported by some users, the update has been rolled back to prevent critical business applications from getting impacted. Drawing Annotations and Point Annotations mode features have now been turned off. We do not have an ETA for performance fixes or when these features will be re-enabled. We sincerely apologize for the inconvenience.Users who used the Drawing Annotations capability while it was available will still be able to access their annotations once the feature Edit. Documentation is re-enabled. Until then, the said annotations will be stored in our application data store but won’t be exposed via the viewers.
2018-03-12

Java SDK v2.15.0 released

  1. Allow retrieving Collaboration fields (#570)
  2. Implement Get Metadata Template by ID (#568)
2018-03-05

Update to Box Annotations

We will be introducing two enhancements to the annotations features available via the Box API that your customer uses in their custom application. The updates are as follows:
  • Point Annotations mode: We are enhancing point annotations by introducing Point Annotations mode. This allows users to expediently add annotations on a document without having to re-select the point annotation icon after each annotation. here.
  • Drawing Annotations via Expiring Embed: We launched Drawing Annotations in November of 2017. This provided end users the ability to free-form draw on their touch-enabled devices using touch or a stylus. We are excited to share that we’re making Drawing Annotations Full release announcement is available via the Expiring Embed. Users using annotations via the Get Embed Link API will now have a whole new way to express themselves via Box Preview.
2018-03-01

Java SDK v2.14.1 released

  1. Add randomization to exponential backoff (#565)
  2. Force TLS version 1.1 or greater when supported (#548)
  3. Delay successive API calls by EventStream (#564)
2018-03-29

Breaking change to Metadata APIs

On March 29, 2018, we will introduce a new data type (array of strings) in the response body of the Metadata API endpoints. We are making this change because we are adding a new field type to metadata templates in Box called multiSelect. This new field type represents a checkbox type multiple selection of values when creating template instances on files or folders. The selected options for this field type are stored in an array of strings, where each string in the array corresponds to the key of the chosen multiSelect option.An example metadata template JSON response body is shown below. The value for the key audience1 shows an example of the new data type (array of strings) that we are introducing in this change.
{
  "audience1": ["internal", "internalEng"],
  "documentType": "Q1 plans",
  "competitiveDocument": "no",
  "status": "active",
  "author": "Jones",
  "currentState": "proposal",
  "$type": "marketingCollateral-d086c908-2498-4d3e-8a1f-01e82bfc2abe",
  "$parent": "file_5010739061",
  "$id": "2094c584-68e1-475c-a581-534a4609594e",
  "$version": 0,
  "$typeVersion": 0,
  "$template": "marketingCollateral",
  "$scope": "enterprise_12345"
}
2018-02-15

Java SDK v2.14.0 released

  1. fixes missing can_view_path property on collaboration object (#560)
  2. Add missing methods and documentation (#559)
  3. Add support for setting tags on items (#554)
2018-02-08

Java SDK v2.13.0 released

  1. Handle metadata values better (#553)
2018-02-01

Java SDK v2.12.0 released

  1. Fix collaboration notify parameter (#545)
  2. Add OAuth 2.0 token creation event type (#533)
  3. Implement invite user to enterprise (#504)
  4. Switch to X-Box-UA header for analytics (#536)
  5. Reduce Large File Upload memory usage (#543)
2018-01-31

Windows .NET SDK v3.4.2 released

Updated Box SDK Version in NuSpec file to fix dependency issues for Box V2 and Box V2.Core.nuget.org/packages/Box.V2/3.4.2 nuget.org/packages/Box.V2.Core/3.4.2
2018-01-25

Java SDK v2.11.0 released

  1. Fix chunked upload for files > 2GB (#531)
  2. Add updated file version upload endpoint and deprecate old method (#524)
  3. Perform modified retry on JWT auth to avoid common JWT errors
2018-01-12

Java SDK v2.10.0 released

  • Add optional is_confirmed parameter for adding user email alias (#499)
  • Add support for token revocation (#510)
  • Metadata template delete (#512)
2018-01-10

Windows .NET SDK v3.4.1 released

Added support for Allowed Collaboration Domains Added Event Type enum Fixed deserialization issue with BoxRepresentationStatusnuget.org/packages/Box.V2/3.4.1 nuget.org/packages/Box.V2.Core/3.4.1
2018-01-04

Java SDK v2.9.0 released

  1. Search readme update (#506)
  2. Add option to pass file SHA-1 hash for upload integrity (#502)
  3. Events log limit (#507)
  4. Terms of Service (#484)
  5. Change wiremock port (#505)
  6. Delete redundant response.disconnect() from moveFolderToUser() (#485)
  7. Events readme patch (#503)
  8. Add missing webhook triggers to enum (#497)
  9. Fix MetadataTemplate.updateMetadataTemplate() type error (#498)
  10. Add missing event types to enum (#500)
  11. Add modified_at timestamp to BoxComment.Info(#501)
  12. Collaboration whitelists (#492)
  13. Trash empty body patch (#495)
  14. Adding support for indefinite Box file locking by allowing null expiration (#494)
  15. Additional test in response for Batch API (#474)
  16. Fixing BoxDeveloperEditionAPIConnection - decryptPrivateKey() - PEMParser returns PrivateKeyInfo already - Invalid cast #470 (#471)