Box Developer Documentation

Box SDK versioning strategy

Guides Tooling Box SDKs Box SDK versioning strategy
Edit this page

Box SDK versioning strategy

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.

Why we are making this change

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.

How it will work

Box core SDKs and Box Next Generation SDKs were created as separate libraries. Going forward, the Box core SDK artifacts will include:

  • (n+1) major version will include manually maintained Box core SDK and Box Next Generation SDK artifacts. This version enables leveraging coexisting artifacts at the same time, and serve as a transition phase. Stay tuned for this upcoming release.
  • v10.0.0 version includes only the Box Next Generation SDK artifact. Currently, this version is available as a branch for each SDK repository.

How to decide

  1. If you are creating a new application, use v10 of the Box core SDK package.
  2. If you have an existing application relying on the Box Next Generation SDK and you wish to further develop your project, replace the name of this library in the package manager with the Box core SDK package (v10.0.0). Object imports for most SDKs will persist the same and your code will work as-is; the TypeScript SDK requires additional steps for migrating. Check the section below for detailed guides.
  3. If you have an existing application relying on Box core SDK and you wish to further develop your project, once released, bump the library version by one major release. See the table above for a detailed breakdown of recommended versions.
  4. If you have an existing application that you don’t plan to change, ensure your package manager includes the version of SDK you are using to prevent an accidental rebuild that pulls in a version you aren’t expecting.

Versioning overview

Box SDK versions and artifacts

Repository nameArtifact nameCurrent latest versionWill include both SDK artifactsIncludes only Box Next Gen SDK artifact
box-python-sdkboxsdkv3.14.0v4.X.Y>=v10.0.0
box-node-sdkbox-node-sdkv3.8.2v4.X.Y>=v10.0.0
box-java-sdkbox-java-sdkv4.16.3v5.X.Y>=v10.0.0
box-windows-sdk-v2Box.V2, Box.V2.Corev5.8.0v6.X.Y>=v10.0.0
box-ios-sdkBoxSDKv5.6.0v6.X.Y>=v10.0.0

Box Next Gen SDK deprecation status

Repository nameArtifact nameCurrent latest versionNote
box-python-sdk-genbox-sdk-genv1.17.0Deprecated, use boxsdk >=v10.0.0
box-typescript-sdk-genbox-typescript-sdk-genv1.19.1Deprecated, use box-node-sdk >=v10.0.0
box-java-sdk-genbox-java-sdk-genv0.8.1Deprecated, use box-java-sdk >=v10.0.0
box-dotnet-sdk-genBox.Sdk.Genv1.12.0Deprecated, use Box.V2.Core >=v10.0.0
box-swift-sdk-genBoxSdkGenv0.6.3Deprecated, use BoxSDK >=v10.0.0

Migration

Migrating from Box Next Generations SDKs to core Box SDK v10

Follow detailed migrations guides to migrate from from Box Next Generations SDKs to Box core SDK v10: