All notable changes to this project will be documented in this file. See standard-version for commit guidelines.
10.6.0 (2026-02-18)
- Correct enum value for legal hold policy changes (box/box-openapi#581) (#1378) (d756351)
- Fix casing for
PATCHinNetwork Client(box/box-codegen#913) (#1366) (53333a0)
- add confidence scores for structured extract (box/box-openapi#582) (#1380) (8c18af1)
- Add configurable timeouts (box/box-codegen#924) (#1403) (fed7629)
- add signer language, cancel sign request reason (box/box-openapi#584) (#1396) (29a5332)
- Add watermarking permissions and sources information (box/box-openapi#579) (#1371) (16e2c6a)
10.5.0 (2025-12-19)
- add taxonomy to Metadata Field (read) definition (box/box-openapi#572) (#1344) (03aea9b)
- Fix convert to long in CSharp (box/box-codegen#911) (#1353) (aacee77)
- add Metadata Taxonomies api (box/box-openapi#569) (#1330) (e054a76)
- text input validation for Box Sign (box/box-openapi#568) (#1324) (9710ac9)
- Treat
nullablefields as Optional (box/box-codegen#906) (#1334) (0c53bda)
10.4.0 (2025-12-12)
- fix
RetryAfterfunction when there's no Retry-After header (box/box-codegen#903) (#1320) (5030d1c) - remove duplicate optional tag (box/box-codegen#898) (#1312) (17b2851)
- Remove
confidence_scoreandinclude_confidence_scorefrom AI extract (box/box-openapi#567) (#1315) (b4af239)
10.3.0 (2025-12-08)
- Support long polling event for dotnet (box/box-codegen#893) (#1298) (e35cd67)
- Support new sign request metadata (box/box-openapi#565) (#1294) (da19f7c)
10.2.0 (2025-11-19)
- Support Archive API (box/box-codegen#865) (#1266) (bca0473)
- Support GET enterprise configuration API (box/box-openapi#559) (#1198) (426aaed)
- Include
pdbfiles when packing .net root project (box/box-codegen#859) (#1169) (8b7e7c8) - Use generated
RetryStrategyfor retrying requests (box/box-codegen#872) (#1232) (5567fef)
10.1.0 (2025-10-06)
- Allow flexible key-value data in
AiExtractResponse.answerandEvent.additionalDetails(box/box-openapi#556) (#1147) (c41a444) - Make
roleparameter of update collaboration optional (box/box-openapi#557) (#1156) (8247918)
10.0.0 (2025-09-17)
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.
- This SDK version is auto-generated and introduces a new interface for all methods. Extensive documentation is available here.
-
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 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
- Change names of unions (box/box-openapi#549) (#1007) (fcef4ec)
- Remove unused models from schemas (box/box-openapi#547) (#999) (ffcb488)
- Fix
net462debug build (#1020) (04f8343) - Rename external user deletion method (box/box-codegen#796) (#1024) (13928c5)
- Add External User Deletion API (box/box-openapi#550) (#1009) (2178bc8)
- Add missing webhook events (box/box-openapi#554) (#1068) (7fe3b99)
- Add Net Framework 462 support for
v10(box/box-codegen#773) (#986) (67366c7) - Allow injecting custom decryption mechanism for
jwt(#974) (b877355)
For more details check migration guide from box-dotnet-sdk-gen v1 to box-windows-sdk-v2 v10.
5.8.0 (2024-07-22)
- Bump
System.IdentityModel.Tokens.Jwtdependency version tov6.35.0(#962) (6e47237), closes #960 #961 - remove
Microsoft.AspNetCore.StaticFilesandSystem.Webdependencies (#964) (2c8eedc)
5.7.1 (2024-06-28)
- Add missing enum values to
BoxSortBy(#953) (1f89bb0), closes #952 - Add missing fields of
EventSource(#956) (138eda5) - do not recreate Random each time (#945) (d03b1ce), closes #944 #944 #944 #944
5.7.0 (2024-02-27)
- add marker-based pagination version of
GetFolderItems(#936) (f877a8f) - Support sign request signer group ID (#938) (096a098)
5.6.1 (2023-11-29)
5.6.0 (2023-09-25)
5.5.0 (2023-09-20)
5.4.0 (2023-09-07)
5.3.0 (2023-09-04)
5.2.2 (2023-05-23)
5.2.1 (2023-04-18)
5.2.0 (2023-03-14)
- add
IdtoMetadataTemplateField(#890) (b7fe214) - add
start_date_fieldanddescriptionto retention policies (#888) (100b722) - add configurable
JWTAudienceclaim (#897) (50219fd) - add shared link support to
GetFolderItemsAsync(#892) (0eba85c)
5.1.0 (2023-01-17)
5.0.0 (2023-01-12)
- upgrade .net framework to 4.6.2 (#881)
- remove deprecated methods (#881)
- remove
use_indexreferences (#881) - return proper object from
GetFileVersionsUnderRetentionForAssignmentAsync(#881)
- upgrade .net framework to 4.6.2 (#881) (f1989aa), closes #863
- remove deprecated methods (#881) (f1989aa), closes #874
- remove
use_indexreferences (#881) (f1989aa), closes #870
- Added pagination option to
IBoxFilesManager#ViewVersionsAsync(#869) (2324495), closes #866 - return proper object from
GetFileVersionsUnderRetentionForAssignmentAsync(#881) (f1989aa), closes #875
4.6.0 (2022-10-18)
- Add
redirect_urlanddeclined_redirect_urlto Sign Request (#853) (5ef2f18) - Add support for modifiable retention policies & enable deleting retention policy assignment (#856) (564904f)
4.5.0 (2022-08-24)
- Add
content-typefield to sign request (#850) (054d3e1) - expose
effective_accessinBoxSharedLink#843 (d84ddd4)
- fix null reference exception when it's not possible to get
runtimeversion from the assembly (#851) (77046fb) - replace infinite retries with exponential backoff strategy in file representations (#835) (f2a5713)
4.4.0 (2022-06-14)
- add
can_editfield toSharedLink(#831) (e0d4197) - add
version_numbertoBoxFileVersion(#820) (f174358) - add upload and delete support for Avatar API (#829) (4dcb84a)
- Fix initialization of
BoxAPIExceptionobject (#828) (a298f01) - properly dispose response on exception (#819) (8415bd3)
4.3.1 (2022-04-19)
4.3.0 (2022-04-01)
- add missing enum to string parsing in several places (#813) (e370282)
- properly cast response when uploading a new file version using session (#810) (73d877f)
4.2.0 (2022-02-10)
- 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)
- 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)
4.1.0 (2021-12-14)
- add configurable Timeout for BoxClient (#779) (ac842ed)
- add file request api (#777) (1098f75)
- add vanity_name to SharedLink (#782) (00a1e26)
4.0.0 (2021-11-02)
- 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)
- Add ability to get files under retention for assignment and file versions under retention for assignment (#734)
- Add
is_collaboration_restricted_to_enterpriseflag support forFolderupdate (#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)
New Features and Enhancements:
- Add filter fields to get file version retentions (#717)
- Add support for search param to get shared link items (#721)
- Add folder lock functionality (#725)
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
copyInstanceOnItemCopyfield for metadata templates (#698)
Bug Fixes:
- Fix bug with JWT Authentication automatic retry (#697)
- Add path parameter sanitization
- Add support for the classification field for Files and Folders
- Fix bug with notification email field deserializing for
BoxUser - Add
fieldsparameter for metadata query - Add ability to set a request timeout for
FoldersManager.UpdateInformationAsync()andUsersManager.MoverUserFolderAsync()
- Add ability to get and set a notification email address for a user
- Fix deadlock issue for JWT authentication in UI elements
- Add support for the uploader display name field for Files and File Versions
- Fixed Authentication Request Retries
- Added the ability to query Box items based on their metadata. The method to do so is
MetadataManager.ExecuteMetadataQueryAsync(). - Added
TrashedAtfield toBoxItemobjects (file, folder, weblink). - Added marker based pagination for get users methods
- Updated retry logic to retry on 503 status codes returned by the API
- Provide better details for debugging, if the HttpClient used to make API requests times out
- Added
fieldsparameter toUsersManager.GetUserInformationAsync() - Added
ExternalAppUserIdproperty toBoxUsermodel - Added the ability to set the
TrackingCodesproperty when updating or creating a user (thanks @Cpcrook!)
- Added missing fields for File Version object.
- Added
FILE_VERSION_RESTOREconstant to Admin Event. - Added action_by field to Enterprise Event.
- Audited missing fields on BoxFile and BoxFolder objects.
- Better error handling and messaging for errors pertaining to OAuth2 error responses.
- Added
sortanddirectionparameters toFoldersManager.GetFolderItemsAsync()to enable sorting the folder items returned - Added a new
SearchManager.QueryAsync()method with correct types for file size filter parameters - Deprecated the
SearchManager.SearchAsync()method, which is superseded bySearchManager.QueryAsync() - Added support for setting the
IsExternalCollabRestrictedparameter when creating and updating Users - Added a
WebProxyproperty toBoxConfiginstances, which can be used to manually set the network proxy used by the SDK
- 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()
- Added
sortanddirectionparameters toclient.SearchManager.SearchAsync()to control sort order - Added
extensionparameter toclient.FilesManager.GetThumbnailAsync()to control which thumbnail format is returned (thanks @guilmori!) - Fixed a bug where query string parameters were not correctly encoded
- Added
SetFileMetadataAsync()andSetFolderMetadataAsync()methods toclient.MetadataManagerto 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
- Added support for passing custom IBoxService to BoxJWTAuth constructor.
- Removed unnecessary package.config from sample files.
- Added trace ID to API response exception message.
- Fix deserialization of translated task assignment status.
- Fixed an issue where some objects related to Events did not have their
.Idproperty correctly deserialized from JSON
- Added the
.InviteEmailproperty toBoxCollaborationobjects, which displays the email address for the invited user in a pending collaboration - Added
.Timezone,.IsExternalCollabRestricted,.Tags, and.Hostnameproperties toBoxUserobjects
- Added
client.FilesManager.GetCollaborationsCollectionAsync()and deprecatedclient.FilesManager.GetCollaborationsAsync()to enable paging through the entire collection of collaborations on a file - Added
client.WebLinksManager.CopyAsync(),client.WebLinksManager.CreateSharedLinkAsync(), andclient.WebLinksManager.DeleteSharedLinkAsync() - Added
client.UsersManager.GetUserAvatarAsync()for retrieving a user's avatar image
- Added support for reading and writing more Group fields
- Fixed an issue where the
UnsharedAtfield of a shared link could not be set tonull - 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
- Added support for Metadata Cascade Policies
- Strong named the assembly.
- Added support for setting flag allowing non owners of a folder to invite collaborators.
- Fixed bug where Xamarin applications would run out of connections
- Added support for Storage Policies
- Fixed an issue where users could not create
BoxClienton Xamarin - Added
Fileproperty toBoxLockobjects 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
- Added support for assigning a Retention Policy to a metadata template
- Added
CONTENT_ACCESSevent type to enum
- Fixed an issue where a "Security protocol not supported" exception could be thrown on MacOS
- Added
client.FilesManager.GetRepresentationContentAsync()for fetching a stream over representation contents - Fixed parsing of some
Sourceobjects onBoxEventobjects
- Switched to exponential backoff when the SDK receives a rate limit or server error response.
- Force support for TLSv1.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
nameparameter optional onRestoreTrashedAsync().
- Deprecated
uploadFileVersionUsingSessionAsync()(which returned just a Box File Version) in favor ofuploadNewVersionUsingSessionAsync()(which returns the entire Box File object containing the Box File Version). - Added support for OAuth2 access token creation type to the AdminEventTypesEnum
- Added
ExpiresAtparam toBoxCollaborationRequest.
- Added support for Collaboration Whitelist endpoint
- Added Event Types Enum
- Fixed deserialization issue with BoxRepresentationStatus (#429)
- Added support for Terms of Service endpoint
- Added support for Metadata Template ID endpoint
- Added missing fields for Folder Model (#414)
- Added support for Representations endpoint
- Added support for Chunked Upload New File Version
- Fixed BoxEventsManager DateTime formatter (#400)
- Added Unified Metadata Support (#379)
- Major version bump to 3, targeting net45
- Upgrading the whole sln to vs2017
- Added support for Recents endpoint
- New operation on Metadata endpoint
- Progress on Chunked Upload New File
- Minor bug fixes