NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #2434 most downloaded on PyPI
Official Box Python SDK
Latest stable
10.19.0
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
131 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
add DocumentSplitManager and document split APIs + OTP for shared links (box/box-openapi#621)
DocumentSplitManager and document split APIs + OTP for shared links (box/box-openapi#621) (98b77e6)metadata_template support and filter_fields to legal hold assignments (box/box-openapi#625) (758e56f)ShuttleManager and shuttle_* APIs for Shuttle v2026 r0 (box/box-openapi#622) (a52c426)verification_method field to Sign Request signer schemas (box/box-openapi#626) (438e678)Your coding agent can read these notes before it upgrades. Set up the MCP server →
update chunked upload to support sha512 and add external_id to DocGen (box/box-openapi#620)
encode text streams as UTF-8 in MultipartStream uploads (box/box-codegen#995)
use FileMini/FolderMini/WebLinkMini in CollaborationItem (box/box-openapi#619)
preserve case-insensitive response headers (box/box-codegen#991)
add Japanese ZIP code validation to sign request (box/box-openapi#615)
add is_collaborated_content_available_when_owner_inactive property (box/box-openapi#613)
Fix dictionary values deserialization (box/box-codegen#966)
Add new event types (box/box-openapi#1703) (box/box-openapi#605)
Add Convert Note API (box/box-codegen#955)
add failure related fields to DocGenJob (box/box-openapi#598)
Mark id field of AIAgentReference required (box/box-openapi#1629) (box/box-openapi#595)
Automate Public API (box/box-openapi#594)
Correct retention_length type hint to accept both integer and string (box/box-codegen#932)
Correct search content type tags to match API (box/box-openapi#591)
tags to match API (box/box-openapi#591) (#1369)LegalHoldPolicyAssignedItem with API (box/box-openapi#1554) (box/box-openapi#590) (#1365) (feb2010)tags to match API (box/box-openapi#591) (#1369) (39fbc7c)Correct enum value for legal hold policy changes (box/box-openapi#581)
add taxonomy to Metadata Field (read) definition (box/box-openapi#572)
Remove confidence_score and include_confidence_score from AI extract (box/box-openapi#567)
Support GET enterprise configuration API (box/box-openapi#559)
Allow flexible key-value data in AiExtractStructuredResponse.answer and Event.additionalDetails (box/box-openapi#556)
…both artifacts. Migration to v10 includes breaking changes, please review the migration guide for details. For more information, see the SDK versionin…
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.
v10Full 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.
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.
v1.17.0Add External User Deletion API (box/box-openapi#550) (#941) (a80ad85)
Add missing webhook events (box/box-openapi#554) (#988) (575ce0b)
Change names of unions (box/box-codegen#789) (#939) (cf2b1d5)
Remove unused models from schemas (box/box-openapi#547) (#932) (6ef6d63), closes box/box-openapi#542 box/box-openapi#544 box/box-codegen#781 box/box-openapi#545
For more details check migration guide from box-python-sdk-gen v1 to box-python-sdk v10.
boxsdkgen: add DocumentSplitManager and document split schemas/docs; support shared link OTP fields (box/box-openapi#621)
DocumentSplitManager and document split schemas/docs; support shared link OTP fields (box/box-openapi#621) (de4d6f6)metadata_template support and filter_fields to legal hold assignments (box/box-openapi#625) (73d3ba4)ShuttleManager and generate shuttle API models/docs (box/box-openapi#622) (#1636) (89a3d8a)verification_method field to Sign Request signer schemas (box/box-openapi#626) (ec11691)boxsdkgen: support sha512 for chunked uploads and add external_id fields (box/box-openapi#620)
boxsdkgen: encode text streams as UTF-8 in MultipartStream uploads (box/box-codegen#995)
boxsdkgen: use FileMini/FolderMini/WebLinkMini in CollaborationItem (box/box-openapi#619)
boxsdkgen: Support upload big file version convenience method (box/box-codegen#988)
boxsdkgen: add Japanese ZIP code validation to sign request (box/box-openapi#615)
boxsdkgen: add is_collaborated_content_available_when_owner_inactive property (box/box-openapi#613)
boxsdkgen: Add new fields to Hubs (box/box-openapi#606)
boxsdkgen: Add new event types (box/box-openapi#1703) (box/box-openapi#605)
boxsdkgen: Add Convert Note API (box/box-codegen#955)
boxsdkgen: add failure related fields to DocGenJob (box/box-openapi#598)
boxsdkgen: Mark id field of AIAgentReference required (box/box-openapi#1629) (box/box-openapi#595)
boxsdkgen: Automate Public API (box/box-openapi#594)
boxsdkgen: Correct retention_length type hint to accept both integer and string (box/box-codegen#932)
boxsdkgen: Correct search content type tags to match API (box/box-openapi#591)
tags to match API (box/box-openapi#591) (#1370)LegalHoldPolicyAssignedItem with API (box/box-openapi#1554) (box/box-openapi#590) (#1366) (6df014e)tags to match API (box/box-openapi#591) (#1370) (213960d)boxsdkgen: add canPublicSharedLinkBeCreated to Hubs (box/box-codegen#928)
boxsdkgen: Correct enum value for legal hold policy changes (box/box-openapi#581)
boxsdkgen: add Metadata Taxonomies api (box/box-openapi#569)
boxsdkgen: Remove confidence_score and include_confidence_score from AI extract (box/box-openapi#567)
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
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 namespace.
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
v4With 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.
This version allows you to gradually migrate your codebase 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.
Add stream_file_content parameter to upload methods
Add support for get AI agent default
add create sign request function with different required parameters
Use upload session urls for chunk upload
Change exception type for missing location header
Remove restriction to version <2 of urllib3 library
do not retry creating a ZIP when response code is 202 (#845) (3f6ed4e), closes #844
Support create sign request with template ID
Fix JSON response validation retry strategy
Support updating all fields of collaboration
Stop processing data for logging when logging is disabled and cache response json
Use the older version of urllib3
Rename filter date parameters in legal hold creation according to the documentation
Add new optional fields for retention_policies and retention_policy_assignments
Retry Connection broken and Connection reset requests errors
Retry CCG and JWT auth requests on connection reset error (#790) (205997d), closes #789
Add support marker in trash get items
One column per quarter.