Mend ensures you have the greatest risk reduction ("Recommended Fix"-highlighted in green) by removing as many vulnerabilities as possible. Click to see how we calculate risk reduction.
Release Notes
box/box-java-sdk (com.box:box-java-sdk)
### [`v2.58.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2580-2021-11-23)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.57.0...v2.58.0)
##### ⚠ BREAKING CHANGES
##### New Features and Enhancements:
- SDK support for new GET /events stream_type: admin_logs_streaming ([#938](https://togithub.com/box/box-java-sdk/pull/938))
- Adding BoxDeveloperEditionAPIConnection#getUserConnection to indicate that we can use this connection for managed users or app users ([#940](https://togithub.com/box/box-java-sdk/pull/940))
##### Bug Fixes:
- Fix for deprecated enums still being used ([#931](https://togithub.com/box/box-java-sdk/issues/931))
### [`v2.57.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2570-2021-10-18)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.56.0...v2.57.0)
##### ⚠ BREAKING CHANGES
##### New Features and Enhancements:
- Add support for marker-based paging in BoxFolder.getChildren ([#927](https://togithub.com/box/box-java-sdk/pull/927))
- Upgraded minimal-json to v0.9.5
- Upgraded jose4j to v0.7.9
- Adding Gradle wrapper in version 4.0.1 ([#928](https://togithub.com/box/box-java-sdk/pull/928))
##### Bug Fixes:
- Fix for infinite recursion ([#924](https://togithub.com/box/box-java-sdk/pull/924))
- Fix unable to set Vanity URL on `BoxSharedLink` for BoxFile and BoxFolder ([#925](https://togithub.com/box/box-java-sdk/issues/925))
### [`v2.56.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2560-2021-08-31)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.55.1...v2.56.0)
##### 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](https://togithub.com/box/box-java-sdk/pull/907))
- Add `tracking_codes` to create User API call ([#910](https://togithub.com/box/box-java-sdk/pull/910))
##### Bug Fixes:
- Fix `url` for `BoxFileRequest.Info` object ([#906](https://togithub.com/box/box-java-sdk/pull/906))
- Attempt to fix thread locking issue on refresh of access token ([#912](https://togithub.com/box/box-java-sdk/pull/912))
### [`v2.55.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2551-2021-07-30)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.55.0...v2.55.1)
##### Bug Fixes:
- Restore methods for Execute Metadata Query, which were removed in ([#890](https://togithub.com/box/box-java-sdk/pull/890)), and mark them as deprecated ([#905](https://togithub.com/box/box-java-sdk/pull/905))
### [`v2.55.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2550-2021-07-26)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.54.0...v2.55.0)
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](https://togithub.com/box/box-java-sdk/pull/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://togithub.com/box/box-java-sdk/issues/889)])([https://github.com/box/box-java-sdk/pull/889](https://togithub.com/box/box-java-sdk/pull/889))
- Add support for `is_external_collab_restricted` parameter for User ([#896](https://togithub.com/box/box-java-sdk/pull/896))
- Add configurable permissions support for `GroupMembership` ([#897](https://togithub.com/box/box-java-sdk/pull/897))
- Add `SHIELD_JUSTIFICATION_APPROVAL` event type ([#898](https://togithub.com/box/box-java-sdk/pull/898))
- Add ability to get files under retention for assignment and file versions under retention for assignment ([#899](https://togithub.com/box/box-java-sdk/pull/899))
- Add `TASK_UPDATE`, `FILE_VERSION_RESTORE` and `ADVANCED_FOLDER_SETTINGS_UPDATE` event types ([#902](https://togithub.com/box/box-java-sdk/pull/902))
- Add SignAPI support ([#904](https://togithub.com/box/box-java-sdk/pull/904))
##### Bug Fixes:
- Add setters for `BoxLegalHoldPolicy` ([#885](https://togithub.com/box/box-java-sdk/pull/885))
- Add setters for `BoxTaskAssignment` ([#886](https://togithub.com/box/box-java-sdk/pull/886))
- Add setters for Group Membership and Web Links ([#887](https://togithub.com/box/box-java-sdk/pull/887))
- Add setters for Webhooks ([#888](https://togithub.com/box/box-java-sdk/pull/888))
- Deprecate `BoxFile.getThumbnail` in favor of `BoxFile.getRepresentationContent` ([#891](https://togithub.com/box/box-java-sdk/pull/891))
### [`v2.54.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2540-2021-04-01)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.53.0...v2.54.0)
##### New Features and Enhancements:
- Add file request support ([#869](https://togithub.com/box/box-java-sdk/pull/869))
##### Bug Fixes:
- Fix `BoxWeblink` deserialization ([#881](https://togithub.com/box/box-java-sdk/pull/881))
### [`v2.53.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2530-2021-01-08)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.52.0...v2.53.0)
##### New Features and Enhancements:
- Add offset and limit parameters to `BoxFolder.getChildren` ([#861](https://togithub.com/box/box-java-sdk/pull/861))
### [`v2.52.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2520-2020-11-24)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.51.1...v2.52.0)
##### New Features and Enhancements:
- Add folder lock functionality ([#856](https://togithub.com/box/box-java-sdk/pull/856))
- Add support for search param to get shared link items ([#855](https://togithub.com/box/box-java-sdk/pull/855))
##### Bug Fixes:
- Fix bug with updating tracking codes ([#857](https://togithub.com/box/box-java-sdk/pull/857))
### [`v2.51.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2511-2020-11-12)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.51.0...v2.51.1)
##### Bug Fixes:
- Fix for cross-enterprise collaborator calls to updateMetadata on files
### [`v2.51.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2510-2020-10-29)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.50.1...v2.51.0)
##### New Features and Enhancements:
- Add support for `copyInstanceOnItemCopy` field for metadata templates ([#850](https://togithub.com/box/box-java-sdk/pull/850))
- Add support for more fields in `BoxCollaborator.Info` ([#843](https://togithub.com/box/box-java-sdk/pull/843))
##### Bug Fixes:
- Update `getAllGroupsByName()` to use documented parameter ([#851](https://togithub.com/box/box-java-sdk/pull/851))
### [`v2.50.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2501-2020-08-20)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.50.0...v2.50.1)
- Fix bug that occurred when downscoping a token for a Box folder ([#832](https://togithub.com/box/box-java-sdk/pull/832))
### [`v2.50.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2500-2020-07-21)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.49.0...v2.50.0)
- API request creation errors are now retried with the same automatic retry logic as 429 and 5XX response errors ([#828](https://togithub.com/box/box-java-sdk/pull/828))
### [`v2.49.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2490-2020-07-17)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.48.0...v2.49.0)
- Fix bug with setting the unshared at date for a shared link ([#819](https://togithub.com/box/box-java-sdk/pull/819))
- Add zip functionality ([#825](https://togithub.com/box/box-java-sdk/pull/825))
- Add `fields` parameter for metadata query ([#826](https://togithub.com/box/box-java-sdk/pull/826))
### [`v2.48.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2480-2020-06-23)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.47.0...v2.48.0)
- Add ability to get groups by name with fields option ([#789](https://togithub.com/box/box-java-sdk/pull/789))
- Add shared link downscoping ([#785](https://togithub.com/box/box-java-sdk/pull/785))
- Deprecate the use of float for Metadata values, in preference of the underlying value (double) ([#811](https://togithub.com/box/box-java-sdk/pull/811))
- Add iterator support for group collaborations ([#813](https://togithub.com/box/box-java-sdk/pull/813))
- Add ability to set the filename when uploading a new version of a file ([#810](https://togithub.com/box/box-java-sdk/pull/810))
- Add support for the classification field for Files and Folders ([#809](https://togithub.com/box/box-java-sdk/pull/809))
- Add support for setting Tracking Codes ([#766](https://togithub.com/box/box-java-sdk/pull/766))
- Fix issue for `getIsExternallyOwned()` for Files and Folders ([#808](https://togithub.com/box/box-java-sdk/pull/808))
### [`v2.47.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2470-2020-04-23)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.46.0...v2.47.0)
- Add support for the uploader display name field for Files and File Versions ([#791](https://togithub.com/box/box-java-sdk/pull/791))
- Fix path parameter sanitization ([#797](https://togithub.com/box/box-java-sdk/pull/797))
### [`v2.46.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2460-2020-04-09)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.45.0...v2.46.0)
- Fix retry logic ([#787](https://togithub.com/box/box-java-sdk/pull/787))
- Retry for 400 `invalid_grant` error in authentication requests (Clock Skew)
- Honor Retry-After header, if present, by waiting for the time specified in the header before retrying
- The concept of setting / getting "Maximum API Requests" has been deprecated in favor of "Maximum API Retries" to more clearly show the number of times a request will be retried after an error response is received.
- Add ability to set expiration date for a collaboration ([#788](https://togithub.com/box/box-java-sdk/pull/788))
- Add path parameter sanitization ([#790](https://togithub.com/box/box-java-sdk/pull/790))
### [`v2.45.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2450-2020-04-02)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.44.1...v2.45.0)
- Add preflight check before chunked uploads ([#782](https://togithub.com/box/box-java-sdk/pull/782))
- Check that part was successfully uploaded for large file uploads before retrying for 500 errors ([#781](https://togithub.com/box/box-java-sdk/pull/781))
- Fix bug with premature disconnect when renaming files and weblinks ([#779](https://togithub.com/box/box-java-sdk/pull/779))
- Add metadata to each item returned by a metadata query ([#778](https://togithub.com/box/box-java-sdk/pull/778))
### [`v2.44.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2441-2020-02-13)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.44.0...v2.44.1)
- Fix formatting bug for Java Logger
- Improve date / time parsing for responses
### [`v2.44.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2440-2020-01-21)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.43.0...v2.44.0)
- Fix Authentication Request Retries
### [`v2.43.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2430-2019-12-20)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.42.0...v2.43.0)
- Throw exceptions for setMetadata on Files and Folders for non-409 errors
### [`v2.42.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2420-2019-12-17)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.41.0...v2.42.0)
- Added Metadata Query support
- Added marker based pagination for get users methods
### [`v2.41.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2410-2019-10-24)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.40.0...v2.41.0)
- Added enum action option for completed in Box Task class.
### [`v2.40.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2400-2019-10-24)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.39.0...v2.40.0)
- General doc changes.
### [`v2.39.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2390-2019-10-17)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.38.0...v2.39.0)
- Deprecated Batch API functionality.
- Added support for [Task completion_rule](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFile.java#L249)
### [`v2.38.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2380-2019-09-19)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.37.0...v2.38.0)
- Added missing fields for File Version: trashed_by, restored_at, purged_at, purged_by.
- Added support for [chunked uploads with file attributes](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#upload-a-large-file-in-chunks-including-attributes).
### [`v2.37.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2370-2019-08-22)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.36.0...v2.37.0)
- Added support for replace in multi-select metadata for [files](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#update-metadata) and
for [folders](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#update-metadata)
- Improved getting started with JWT authentication docs that can be found [here](https://togithub.com/box/box-java-sdk/blob/main/doc/authentication.md#server-authentication-with-jwt)
### [`v2.36.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2360-2019-08-01)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.35.0...v2.36.0)
- Added support for [removing shared link](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxItem.java#L413) and fixed an issue with setting null for shared link field on BoxItem.
- Added support for additional fields for Box files, folders, and web links.
### [`v2.35.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2350-2019-07-18)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.34.0...v2.35.0)
- Added support for retrieving [is_external_only field](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFile.java#L1668) for Box Files and Folders.
### [`v2.34.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2340-2019-06-06)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.33.0...v2.34.0)
- Added support for retrieving a [string type action for tasks](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxTask.java#L281).
Please use getActionType() going forward instead of the deprecated getAction().
### [`v2.33.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2330-2019-05-23)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.32.0...v2.33.0)
- Added support for [setting can_owners_invite field](https://togithub.com/box/box-java-sdk/blob/1ed10d7a457e44b863ec1c9b1d0d1408fb55e1e5/src/main/java/com/box/sdk/BoxFolder.java#L1272) Thank you [@Band-Aid](https://togithub.com/Band-Aid) for you pull request! Greatly Appreciated.
- Fixed a bug where chunked upload was not populating the correct part size for upload part.
### [`v2.32.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2320-2019-04-25)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.31.0...v2.32.0)
- Added support [setting metadata](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#set-metadata).
### [`v2.31.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2310-2019-04-11)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.30.1...v2.31.0)
- Added support for [sorting folder items](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#get-a-folders-items) retrieved from a folder by ascending or descending order.
### [`v2.30.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2301-2019-04-08)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.30.0...v2.30.1)
- Fixed a bug where the SDK could throw when parsing JSON containing dates using the Zulu timezone format
### [`v2.30.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2300-2019-04-04)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.29.0...v2.30.0)
- Added `action_by` field to enterprise events stream.
### [`v2.29.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2290-2019-04-01)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.28.1...v2.29.0)
- Added support for [sorting results returned from Box Search](https://togithub.com/box/box-java-sdk/blob/main/doc/search.md#search-1)
- Added ability to [attach a file description upon file upload](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#upload-a-file)
### [`v2.28.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2281-2019-03-07)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.28.0...v2.28.1)
- Fixed a bug where BoxMetadataCascadePolicy.forceApply() would not return correctly.
### [`v2.28.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2280-2019-02-21)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.27.0...v2.28.0)
- Added ability for user to [retrieve an avatar](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxUser.html#getAvatar--)) for a specified user.
### [`v2.27.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2270-2019-01-31)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.26.0...v2.27.0)
- Added support for Metadata Classification for [File](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFile.html#setClassification-java.lang.String...-) and [Folder](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFolder.html#setClassification-java.lang.String...-)
### [`v2.26.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2260-2019-01-17)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.25.1...v2.26.0)
- Added [invite_email](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxCollaboration.java#L277) field to collaboration object.
- Added [is_collaboration_restricted_to_enterprise](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFolder.java#L1104) field to folder object.
- Added [status](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxTaskAssignment.java#L196) field to task assignment object.
- Added ability to retrieve fields for [`BoxFile#getTasks()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFile.html#getTasks-java.lang.String...-)
- Fixed bug where offset based paging would not return correctly.
### [`v2.25.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2251-2019-01-03)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.25.0...v2.25.1)
- Upgraded dependencies: jose4j to v0.5.5, and bouncycastle to v1.60
### [`v2.25.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2250-2018-12-13)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.24.0...v2.25.0)
- Added functionality to allow [content streaming to Box through outputstream](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFolder.html#uploadFile-com.box.UploadFileCallback-java.lang.String-). Thank you [@gajarajkalburgi](https://togithub.com/gajarajkalburgi) for the pr!
### [`v2.24.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2240-2018-11-16)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.23.2...v2.24.0)
- Added `getOptionsObjects()` on `MetadataTemplate.Field` which returns both key and type.
- Added functionality for [`BoxItem#getType()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxItem.html#getType--) for BoxItem.
- Added functionality for [`BoxAPIConnection#BoxGlobalSettings()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxAPIConnection.html#setConnectTimeout-java.lang.String-)
and [`BoxAPIConnection#BoxGlobalSettings()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxAPIConnection.html#getConnectTimeout--) as well as getting and reading the timeout for the connection.
- Added functionality for [`BoxGlobalSettings#getMaxRequestAttempts()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxGlobalSettings.html#getMaxRequestAttempts--)
and [`BoxGlobalSettings#setMaxRquestAttempts()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxGlobalSettings.html#setMaxRequestAttempts-java.lang.Integer-)
- Fixed a bug where [`BoxLegalHoldPolicy#create()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxLegalHoldPolicy.html#create-com.box.BoxAPIConnection-java.lang.String-) was not setting the correct legal hold policy duration.
### [`v2.23.2`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2232-2018-09-27)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.23.1...v2.23.2)
- Fixed a bug where the specified headers for batch requests were not being sent.
### [`v2.23.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2231-2018-09-13)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.23.0...v2.23.1)
- Fixed a bug where too many TCP connections were being opened. Thank you [@pmatte1](https://togithub.com/pmatte1) for implementing this fix!
### [`v2.23.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2230-2018-08-23)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.22.0...v2.23.0)
- Added support for [Metadata Cascade Policy](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#create-cascade-policy-on-folder)
### [`v2.22.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2220-2018-08-09)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.21.0...v2.22.0)
- Deprecated the [moveFolderToUser()](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxUser.java#L455) for Box Users. We encourage users to
use [transferContent](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxUser.java#L482) going forward because idiomatically it is more correct.
### [`v2.21.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2210-2018-07-05)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.20.2...v2.21.0)
- Added functionality to allow users to [set passwords on shared links](https://togithub.com/box/box-java-sdk/pull/623) for Box files, folders, and web links.
- Fixed wrong redirect for two links in the `Getting Started` and `Quick Test` section of the README.
### [`v2.20.2`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2202-2018-06-28)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.20.1...v2.20.2)
- Fixed a bug where customers had issues with large file uploads because they fail to parse the Retry-After header from the
commit response. Reason being headers storage/lookup was case sensitive.
### [`v2.20.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2201-2018-06-04)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.20.0...v2.20.1)
- Added better exception handling for JSON parse in response exception.
- Fixed a bug where uploadNewVersion() was returning an empty object.
### [`v2.20.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2200-2018-05-24)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.19.0...v2.20.0)
- Fixed a bug where multiple As-User headers could be set.
- Added support to [test update](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/Metadata.html#test-java.lang.String-java.util.List-) for multiselect field on metadata
### [`v2.19.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2190-2018-05-10)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.18.0...v2.19.0)
- Added support for enterprise admins with Box Zones purchased to have support for [Box Storage Policies and Box Storage Policy Assignments](./doc/storage_policy)
- Added support to allow users to work with [multiselect metadata](./doc/files.md#get-metadata)
- Added `getLogin()` method for the "login" field on the "accessible by" for BoxCollaboration.Info class.
### [`v2.18.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2180-2018-04-30)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.17.0...v2.18.0)
- Fixed a bug where the the private key password should be passed into `setPrivateKetPassword()` instead of the private key. A big thank you to [breach10ck](https://togithub.com/breach10ck)
for their pull request!
- Added an additional check to ensure that the [request properties on the request object is not null in the `toString()` method](https://togithub.com/box/box-java-sdk/pull/595)
- Added support to [fetch the content of the generated representation](./doc/files.md#get-representation-content) after it has been generated
- Improved error messages for API response errors to allow for better debugging.
### [`v2.17.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2170-2018-04-10)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.16.1...v2.17.0)
- Added support for assigning [Retention Policies to Metadata Templates](./doc/retention_policies.md#create-retention-policy-assignment)
### [`v2.16.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2161-2018-03-29)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.16.0...v2.16.1)
- Added `CONTENT_ACCESS` to event type enum
### [`v2.16.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2160-2018-03-22)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.15.0...v2.16.0)
- Added support for [user tracking codes](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxUser.Info.html#getTrackingCodes--) on the user object.
- Fixed a bug where JWT authentication would fail due to improper date parsing.
- Added support for setting custom headers on API connection. This allow for setting [As-User support](./doc/overview.md#as-user)
and [suppressing notifications](./doc/overview.md/suppressing-notifications) support.
- Changed default JWT expiration window to reduce chances of error.
### [`v2.15.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2150-2018-03-12)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.14.1...v2.15.0)
- Added support for retrieving a [metadata template by ID](./doc/metadata_template.md#get-by-id)
- Added support for allowing the user to [retrieve specific Collaboration fields on a Collaboration object](./doc/collaborations.md#get-a-collaborations-information)
### [`v2.14.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2141-2018-03-01)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.14.0...v2.14.1)
- Reduced the number of API calls that the `EventStream` makes to fetch new events, which should
help users who are running into rate limit issues.
- Force support for TLSv1.1 or higher when available to improve the security of connections to the Box API
- Add randomized jitter to the exponential backoff algorithm used by the SDK to improve the success rate
of retried requests.
### [`v2.14.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2140-2018-02-15)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.13.0...v2.14.0)
- Added support for getting and setting the `can_view_path` field on a collaboration object.
- Added support for getting and setting the `tags` field on files and folders.
### [`v2.13.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2130-2018-02-07)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.12.0...v2.13.0)
- Fixed an issue where all types of metadata values were being coerced to Strings. This change deprecates
`Metadata#get()` in favor of type-specific methods like `Metadata#getFloat()` or a generic `Metadata#getValue()`,
which returns a `JsonValue` object that represents any JSON type. See the [file metadata](./doc/files.md#get-metadata)
or [folder metadata](./doc/folders.md#get-metadata) documentation for more information.
### [`v2.12.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2120-2018-02-01)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.11.0...v2.12.0)
- Fixed ability to notify users or groups regarding [file collaboration](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#share-a-file) or [folder collaboration](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#share-a-folder)
- Added [OAuth2 token creation event types](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxEvent.java#L747)
- Added support for [inviting a user to another Box Enterprise](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxInvite.html)
- Fixed an [OutOfMemory error in large file upload by capping the maximum number of parts that are uploaded concurrently](https://togithub.com/box/box-java-sdk/pull/543)
### [`v2.11.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2110-2018-01-25)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.10.0...v2.11.0)
- [uploadLargeFile now returns a BoxFile object](https://togithub.com/box/box-java-sdk/pull/524)
- [Fixed chunked upload for Box Files greater than 2GB](https://togithub.com/box/box-java-sdk/pull/531)
- [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](https://togithub.com/box/box-java-sdk/pull/523)
- BoxFolder.search has been deprecated in favor of [BoxSearch.searchRange](https://togithub.com/box/box-java-sdk/blob/86b82f2be3c57e3b89ae150b5f237d410e2d4900/doc/search.md)
### [`v2.10.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2100-2018-01-11)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.9.0...v2.10.0)
- [Add optional is_confirmed paramater for adding user email alias](https://togithub.com/box/box-java-sdk/pull/499)
- Added support for [Metadata Template Delete](./doc/metadata_template#delete-a-metadata-template)
### [`v2.9.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#290-2018-01-04)
- Added option to pass file [SHA-1 hash for upload integrity](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#upload-a-file)
- Added support for [Terms of Service](./doc/terms_of_service) endpoint
- Fixed missing [webhook triggers](https://togithub.com/box/box-java-sdk/pull/497)
- Fixed missing [event types for events enum](https://togithub.com/box/box-java-sdk/pull/500)
- Added [modified_at timestamp to BoxComment.Info](https://togithub.com/box/box-java-sdk/pull/499)
- Added support for [Collaboration Whitelists](./doc/collaboration_whitelists) endpoint
### [`v2.8.2`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#282-2017-10-05)
- Added additional check for `PrivateKeyInfo` in `BoxDeveloperEditionApiConnection`
### [`v2.8.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#281-2017-10-05)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.8.0...v2.8.1)
- Added ability to [set connect and read timeout globally](https://togithub.com/box/box-java-sdk/pull/459)
### [`v2.8.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#280-2017-09-07)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.7.0...v2.8.0)
- Added method for getting file representations
- Changes to Representation object
### [`v2.7.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#270-2017-08-30)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.6.0...v2.7.0)
- Added support for [Representations](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFile.java#L445) endpoint
### [`v2.6.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#260-2017-08-28)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.5.0...v2.6.0)
- Added support for [Batch](https://togithub.com/box/box-java-sdk/blob/575861fad0b3e67d432b5d5955d1e760b3f6444e/README.md#batchrequestexample)
- Added support for [Unified Metadata](./doc/folders#get-metadata-using-unified-metadata-api)
### [`v2.5.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#250-2017-07-28)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.4.0...v2.5.0)
- Added support for [Recent Items](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxRecents.java#L1) endpoint
- Added support [Get All Groups By Name](https://togithub.com/box/box-java-sdk/blob/a1833950c18139fd9cbb4d8ee61d310c7bbedadf/src/main/java/com/box/sdk/BoxGroup.java#L143) endpoint
- Added support for [Token Exchange](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxAPIConnection.java#L634)
### [`v2.4.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#240-2017-05-02)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.3.0...v2.4.0)
- Support for multiput upload. New methods in BoxFolder and BoxFile support multiput upload for better performance and reliability for large files.
- Single file collaborations. The BoxFile class now supports sharing individual files.
- Automatic configuration for JWT auth. The Box Developer console now lets you download a JSON file of your JWT app configuration settings. You can import this file into the Java SDK to easily configure your app.
### [`v2.3.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#230-2017-01-12)
[Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.1.1...v2.3.0)
New API Endpoints:
[Legal Holds](https://togithub.com/box/box-java-sdk/blob/main/doc/legal_holds.md)
[Retention Policies](https://togithub.com/box/box-java-sdk/blob/main/doc/retention_policies.md)
[Create Metadata Template](https://togithub.com/box/box-java-sdk/blob/main/doc/metadata_template.md#create-metadata-template)
[Get All Metadata on File](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#get-all-metadata-on-file)
[Get All Metadata on Folder](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#get-all-metadata-on-folder)
[Get Enterprise Metadata Templates](https://togithub.com/box/box-java-sdk/blob/main/doc/metadata_template.md#get-enterprise-metadata-templates)
[Update Group](https://togithub.com/box/box-java-sdk/blob/main/doc/groups.md#update-a-group)
[Watermarking](https://togithub.com/box/box-java-sdk/blob/main/doc/watermarking.md)
[Webhooks V2](https://togithub.com/box/box-java-sdk/blob/main/doc/webhooks.md)
[WebLinks](https://togithub.com/box/box-java-sdk/blob/main/doc/weblinks.md)
[Collections](https://togithub.com/box/box-java-sdk/blob/main/doc/collections.md)
[BoxGroupMembership with for Paging](https://togithub.com/box/box-java-sdk/blob/main/doc/groups.md)
[Enterprise Device Pins](https://togithub.com/box/box-java-sdk/blob/86b82f2be3c57e3b89ae150b5f237d410e2d4900/doc/devices.md)
New Features:
Transactional Authentication. Support for Box's new Transactional Auth APIs.
Upload file versions with SHA1. A file's SHA1 can be passed in to BoxFile.uploadVersion(...) when uploading new versions.
Get effective_access for shared links. The effective_access field is accessible through BoxSharedLink. getEffectiveAccess().
Added additional Event Types. The TASK_ASSIGNMENT_COMPLETE, TASK_ASSIGNMENT_UPDATE, TASK_CREATE, COMMENT_DELETE types are now included in the BoxEvent class.
[ ] If you want to rebase/retry this PR, check this box
This PR contains the following updates:
2.1.1->2.58.0This PR resolves the vulnerabilities described in Issue #10
Version 2.1.1
| Risk ChangeVersion 2.58.0
| Risk ChangeMend ensures you have the greatest risk reduction ("Recommended Fix"-highlighted in green) by removing as many vulnerabilities as possible. Click to see how we calculate risk reduction.
Release Notes
box/box-java-sdk (com.box:box-java-sdk)
### [`v2.58.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2580-2021-11-23) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.57.0...v2.58.0) ##### ⚠ BREAKING CHANGES ##### New Features and Enhancements: - SDK support for new GET /events stream_type: admin_logs_streaming ([#938](https://togithub.com/box/box-java-sdk/pull/938)) - Adding BoxDeveloperEditionAPIConnection#getUserConnection to indicate that we can use this connection for managed users or app users ([#940](https://togithub.com/box/box-java-sdk/pull/940)) ##### Bug Fixes: - Fix for deprecated enums still being used ([#931](https://togithub.com/box/box-java-sdk/issues/931)) ### [`v2.57.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2570-2021-10-18) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.56.0...v2.57.0) ##### ⚠ BREAKING CHANGES ##### New Features and Enhancements: - Add support for marker-based paging in BoxFolder.getChildren ([#927](https://togithub.com/box/box-java-sdk/pull/927)) - Upgraded minimal-json to v0.9.5 - Upgraded jose4j to v0.7.9 - Adding Gradle wrapper in version 4.0.1 ([#928](https://togithub.com/box/box-java-sdk/pull/928)) ##### Bug Fixes: - Fix for infinite recursion ([#924](https://togithub.com/box/box-java-sdk/pull/924)) - Fix unable to set Vanity URL on `BoxSharedLink` for BoxFile and BoxFolder ([#925](https://togithub.com/box/box-java-sdk/issues/925)) ### [`v2.56.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2560-2021-08-31) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.55.1...v2.56.0) ##### 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](https://togithub.com/box/box-java-sdk/pull/907)) - Add `tracking_codes` to create User API call ([#910](https://togithub.com/box/box-java-sdk/pull/910)) ##### Bug Fixes: - Fix `url` for `BoxFileRequest.Info` object ([#906](https://togithub.com/box/box-java-sdk/pull/906)) - Attempt to fix thread locking issue on refresh of access token ([#912](https://togithub.com/box/box-java-sdk/pull/912)) ### [`v2.55.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2551-2021-07-30) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.55.0...v2.55.1) ##### Bug Fixes: - Restore methods for Execute Metadata Query, which were removed in ([#890](https://togithub.com/box/box-java-sdk/pull/890)), and mark them as deprecated ([#905](https://togithub.com/box/box-java-sdk/pull/905)) ### [`v2.55.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2550-2021-07-26) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.54.0...v2.55.0) 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](https://togithub.com/box/box-java-sdk/pull/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://togithub.com/box/box-java-sdk/issues/889)])([https://github.com/box/box-java-sdk/pull/889](https://togithub.com/box/box-java-sdk/pull/889)) - Add support for `is_external_collab_restricted` parameter for User ([#896](https://togithub.com/box/box-java-sdk/pull/896)) - Add configurable permissions support for `GroupMembership` ([#897](https://togithub.com/box/box-java-sdk/pull/897)) - Add `SHIELD_JUSTIFICATION_APPROVAL` event type ([#898](https://togithub.com/box/box-java-sdk/pull/898)) - Add ability to get files under retention for assignment and file versions under retention for assignment ([#899](https://togithub.com/box/box-java-sdk/pull/899)) - Add `TASK_UPDATE`, `FILE_VERSION_RESTORE` and `ADVANCED_FOLDER_SETTINGS_UPDATE` event types ([#902](https://togithub.com/box/box-java-sdk/pull/902)) - Add SignAPI support ([#904](https://togithub.com/box/box-java-sdk/pull/904)) ##### Bug Fixes: - Add setters for `BoxLegalHoldPolicy` ([#885](https://togithub.com/box/box-java-sdk/pull/885)) - Add setters for `BoxTaskAssignment` ([#886](https://togithub.com/box/box-java-sdk/pull/886)) - Add setters for Group Membership and Web Links ([#887](https://togithub.com/box/box-java-sdk/pull/887)) - Add setters for Webhooks ([#888](https://togithub.com/box/box-java-sdk/pull/888)) - Deprecate `BoxFile.getThumbnail` in favor of `BoxFile.getRepresentationContent` ([#891](https://togithub.com/box/box-java-sdk/pull/891)) ### [`v2.54.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2540-2021-04-01) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.53.0...v2.54.0) ##### New Features and Enhancements: - Add file request support ([#869](https://togithub.com/box/box-java-sdk/pull/869)) ##### Bug Fixes: - Fix `BoxWeblink` deserialization ([#881](https://togithub.com/box/box-java-sdk/pull/881)) ### [`v2.53.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2530-2021-01-08) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.52.0...v2.53.0) ##### New Features and Enhancements: - Add offset and limit parameters to `BoxFolder.getChildren` ([#861](https://togithub.com/box/box-java-sdk/pull/861)) ### [`v2.52.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2520-2020-11-24) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.51.1...v2.52.0) ##### New Features and Enhancements: - Add folder lock functionality ([#856](https://togithub.com/box/box-java-sdk/pull/856)) - Add support for search param to get shared link items ([#855](https://togithub.com/box/box-java-sdk/pull/855)) ##### Bug Fixes: - Fix bug with updating tracking codes ([#857](https://togithub.com/box/box-java-sdk/pull/857)) ### [`v2.51.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2511-2020-11-12) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.51.0...v2.51.1) ##### Bug Fixes: - Fix for cross-enterprise collaborator calls to updateMetadata on files ### [`v2.51.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2510-2020-10-29) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.50.1...v2.51.0) ##### New Features and Enhancements: - Add support for `copyInstanceOnItemCopy` field for metadata templates ([#850](https://togithub.com/box/box-java-sdk/pull/850)) - Add support for more fields in `BoxCollaborator.Info` ([#843](https://togithub.com/box/box-java-sdk/pull/843)) ##### Bug Fixes: - Update `getAllGroupsByName()` to use documented parameter ([#851](https://togithub.com/box/box-java-sdk/pull/851)) ### [`v2.50.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2501-2020-08-20) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.50.0...v2.50.1) - Fix bug that occurred when downscoping a token for a Box folder ([#832](https://togithub.com/box/box-java-sdk/pull/832)) ### [`v2.50.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2500-2020-07-21) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.49.0...v2.50.0) - API request creation errors are now retried with the same automatic retry logic as 429 and 5XX response errors ([#828](https://togithub.com/box/box-java-sdk/pull/828)) ### [`v2.49.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2490-2020-07-17) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.48.0...v2.49.0) - Fix bug with setting the unshared at date for a shared link ([#819](https://togithub.com/box/box-java-sdk/pull/819)) - Add zip functionality ([#825](https://togithub.com/box/box-java-sdk/pull/825)) - Add `fields` parameter for metadata query ([#826](https://togithub.com/box/box-java-sdk/pull/826)) ### [`v2.48.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2480-2020-06-23) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.47.0...v2.48.0) - Add ability to get groups by name with fields option ([#789](https://togithub.com/box/box-java-sdk/pull/789)) - Add shared link downscoping ([#785](https://togithub.com/box/box-java-sdk/pull/785)) - Deprecate the use of float for Metadata values, in preference of the underlying value (double) ([#811](https://togithub.com/box/box-java-sdk/pull/811)) - Add iterator support for group collaborations ([#813](https://togithub.com/box/box-java-sdk/pull/813)) - Add ability to set the filename when uploading a new version of a file ([#810](https://togithub.com/box/box-java-sdk/pull/810)) - Add support for the classification field for Files and Folders ([#809](https://togithub.com/box/box-java-sdk/pull/809)) - Add support for setting Tracking Codes ([#766](https://togithub.com/box/box-java-sdk/pull/766)) - Fix issue for `getIsExternallyOwned()` for Files and Folders ([#808](https://togithub.com/box/box-java-sdk/pull/808)) ### [`v2.47.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2470-2020-04-23) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.46.0...v2.47.0) - Add support for the uploader display name field for Files and File Versions ([#791](https://togithub.com/box/box-java-sdk/pull/791)) - Fix path parameter sanitization ([#797](https://togithub.com/box/box-java-sdk/pull/797)) ### [`v2.46.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2460-2020-04-09) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.45.0...v2.46.0) - Fix retry logic ([#787](https://togithub.com/box/box-java-sdk/pull/787)) - Retry for 400 `invalid_grant` error in authentication requests (Clock Skew) - Honor Retry-After header, if present, by waiting for the time specified in the header before retrying - The concept of setting / getting "Maximum API Requests" has been deprecated in favor of "Maximum API Retries" to more clearly show the number of times a request will be retried after an error response is received. - Add ability to set expiration date for a collaboration ([#788](https://togithub.com/box/box-java-sdk/pull/788)) - Add path parameter sanitization ([#790](https://togithub.com/box/box-java-sdk/pull/790)) ### [`v2.45.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2450-2020-04-02) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.44.1...v2.45.0) - Add preflight check before chunked uploads ([#782](https://togithub.com/box/box-java-sdk/pull/782)) - Check that part was successfully uploaded for large file uploads before retrying for 500 errors ([#781](https://togithub.com/box/box-java-sdk/pull/781)) - Fix bug with premature disconnect when renaming files and weblinks ([#779](https://togithub.com/box/box-java-sdk/pull/779)) - Add metadata to each item returned by a metadata query ([#778](https://togithub.com/box/box-java-sdk/pull/778)) ### [`v2.44.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2441-2020-02-13) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.44.0...v2.44.1) - Fix formatting bug for Java Logger - Improve date / time parsing for responses ### [`v2.44.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2440-2020-01-21) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.43.0...v2.44.0) - Fix Authentication Request Retries ### [`v2.43.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2430-2019-12-20) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.42.0...v2.43.0) - Throw exceptions for setMetadata on Files and Folders for non-409 errors ### [`v2.42.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2420-2019-12-17) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.41.0...v2.42.0) - Added Metadata Query support - Added marker based pagination for get users methods ### [`v2.41.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2410-2019-10-24) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.40.0...v2.41.0) - Added enum action option for completed in Box Task class. ### [`v2.40.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2400-2019-10-24) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.39.0...v2.40.0) - General doc changes. ### [`v2.39.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2390-2019-10-17) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.38.0...v2.39.0) - Deprecated Batch API functionality. - Added support for [Task completion_rule](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFile.java#L249) ### [`v2.38.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2380-2019-09-19) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.37.0...v2.38.0) - Added missing fields for File Version: trashed_by, restored_at, purged_at, purged_by. - Added support for [chunked uploads with file attributes](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#upload-a-large-file-in-chunks-including-attributes). ### [`v2.37.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2370-2019-08-22) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.36.0...v2.37.0) - Added support for replace in multi-select metadata for [files](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#update-metadata) and for [folders](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#update-metadata) - Improved getting started with JWT authentication docs that can be found [here](https://togithub.com/box/box-java-sdk/blob/main/doc/authentication.md#server-authentication-with-jwt) ### [`v2.36.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2360-2019-08-01) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.35.0...v2.36.0) - Added support for [removing shared link](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxItem.java#L413) and fixed an issue with setting null for shared link field on BoxItem. - Added support for additional fields for Box files, folders, and web links. ### [`v2.35.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2350-2019-07-18) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.34.0...v2.35.0) - Added support for retrieving [is_external_only field](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFile.java#L1668) for Box Files and Folders. ### [`v2.34.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2340-2019-06-06) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.33.0...v2.34.0) - Added support for retrieving a [string type action for tasks](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxTask.java#L281). Please use getActionType() going forward instead of the deprecated getAction(). ### [`v2.33.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2330-2019-05-23) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.32.0...v2.33.0) - Added support for [setting can_owners_invite field](https://togithub.com/box/box-java-sdk/blob/1ed10d7a457e44b863ec1c9b1d0d1408fb55e1e5/src/main/java/com/box/sdk/BoxFolder.java#L1272) Thank you [@Band-Aid](https://togithub.com/Band-Aid) for you pull request! Greatly Appreciated. - Fixed a bug where chunked upload was not populating the correct part size for upload part. ### [`v2.32.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2320-2019-04-25) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.31.0...v2.32.0) - Added support [setting metadata](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#set-metadata). ### [`v2.31.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2310-2019-04-11) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.30.1...v2.31.0) - Added support for [sorting folder items](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#get-a-folders-items) retrieved from a folder by ascending or descending order. ### [`v2.30.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2301-2019-04-08) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.30.0...v2.30.1) - Fixed a bug where the SDK could throw when parsing JSON containing dates using the Zulu timezone format ### [`v2.30.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2300-2019-04-04) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.29.0...v2.30.0) - Added `action_by` field to enterprise events stream. ### [`v2.29.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2290-2019-04-01) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.28.1...v2.29.0) - Added support for [sorting results returned from Box Search](https://togithub.com/box/box-java-sdk/blob/main/doc/search.md#search-1) - Added ability to [attach a file description upon file upload](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#upload-a-file) ### [`v2.28.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2281-2019-03-07) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.28.0...v2.28.1) - Fixed a bug where BoxMetadataCascadePolicy.forceApply() would not return correctly. ### [`v2.28.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2280-2019-02-21) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.27.0...v2.28.0) - Added ability for user to [retrieve an avatar](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxUser.html#getAvatar--)) for a specified user. ### [`v2.27.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2270-2019-01-31) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.26.0...v2.27.0) - Added support for Metadata Classification for [File](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFile.html#setClassification-java.lang.String...-) and [Folder](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFolder.html#setClassification-java.lang.String...-) ### [`v2.26.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2260-2019-01-17) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.25.1...v2.26.0) - Added [invite_email](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxCollaboration.java#L277) field to collaboration object. - Added [is_collaboration_restricted_to_enterprise](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFolder.java#L1104) field to folder object. - Added [status](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxTaskAssignment.java#L196) field to task assignment object. - Added ability to retrieve fields for [`BoxFile#getTasks()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFile.html#getTasks-java.lang.String...-) - Fixed bug where offset based paging would not return correctly. ### [`v2.25.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2251-2019-01-03) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.25.0...v2.25.1) - Upgraded dependencies: jose4j to v0.5.5, and bouncycastle to v1.60 ### [`v2.25.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2250-2018-12-13) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.24.0...v2.25.0) - Added functionality to allow [content streaming to Box through outputstream](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxFolder.html#uploadFile-com.box.UploadFileCallback-java.lang.String-). Thank you [@gajarajkalburgi](https://togithub.com/gajarajkalburgi) for the pr! ### [`v2.24.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2240-2018-11-16) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.23.2...v2.24.0) - Added `getOptionsObjects()` on `MetadataTemplate.Field` which returns both key and type. - Added functionality for [`BoxItem#getType()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxItem.html#getType--) for BoxItem. - Added functionality for [`BoxAPIConnection#BoxGlobalSettings()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxAPIConnection.html#setConnectTimeout-java.lang.String-) and [`BoxAPIConnection#BoxGlobalSettings()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxAPIConnection.html#getConnectTimeout--) as well as getting and reading the timeout for the connection. - Added functionality for [`BoxGlobalSettings#getMaxRequestAttempts()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxGlobalSettings.html#getMaxRequestAttempts--) and [`BoxGlobalSettings#setMaxRquestAttempts()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxGlobalSettings.html#setMaxRequestAttempts-java.lang.Integer-) - Fixed a bug where [`BoxLegalHoldPolicy#create()`](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxLegalHoldPolicy.html#create-com.box.BoxAPIConnection-java.lang.String-) was not setting the correct legal hold policy duration. ### [`v2.23.2`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2232-2018-09-27) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.23.1...v2.23.2) - Fixed a bug where the specified headers for batch requests were not being sent. ### [`v2.23.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2231-2018-09-13) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.23.0...v2.23.1) - Fixed a bug where too many TCP connections were being opened. Thank you [@pmatte1](https://togithub.com/pmatte1) for implementing this fix! ### [`v2.23.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2230-2018-08-23) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.22.0...v2.23.0) - Added support for [Metadata Cascade Policy](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#create-cascade-policy-on-folder) ### [`v2.22.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2220-2018-08-09) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.21.0...v2.22.0) - Deprecated the [moveFolderToUser()](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxUser.java#L455) for Box Users. We encourage users to use [transferContent](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxUser.java#L482) going forward because idiomatically it is more correct. ### [`v2.21.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2210-2018-07-05) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.20.2...v2.21.0) - Added functionality to allow users to [set passwords on shared links](https://togithub.com/box/box-java-sdk/pull/623) for Box files, folders, and web links. - Fixed wrong redirect for two links in the `Getting Started` and `Quick Test` section of the README. ### [`v2.20.2`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2202-2018-06-28) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.20.1...v2.20.2) - Fixed a bug where customers had issues with large file uploads because they fail to parse the Retry-After header from the commit response. Reason being headers storage/lookup was case sensitive. ### [`v2.20.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2201-2018-06-04) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.20.0...v2.20.1) - Added better exception handling for JSON parse in response exception. - Fixed a bug where uploadNewVersion() was returning an empty object. ### [`v2.20.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2200-2018-05-24) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.19.0...v2.20.0) - Fixed a bug where multiple As-User headers could be set. - Added support to [test update](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/Metadata.html#test-java.lang.String-java.util.List-) for multiselect field on metadata ### [`v2.19.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2190-2018-05-10) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.18.0...v2.19.0) - Added support for enterprise admins with Box Zones purchased to have support for [Box Storage Policies and Box Storage Policy Assignments](./doc/storage_policy) - Added support to allow users to work with [multiselect metadata](./doc/files.md#get-metadata) - Added `getLogin()` method for the "login" field on the "accessible by" for BoxCollaboration.Info class. ### [`v2.18.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2180-2018-04-30) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.17.0...v2.18.0) - Fixed a bug where the the private key password should be passed into `setPrivateKetPassword()` instead of the private key. A big thank you to [breach10ck](https://togithub.com/breach10ck) for their pull request! - Added an additional check to ensure that the [request properties on the request object is not null in the `toString()` method](https://togithub.com/box/box-java-sdk/pull/595) - Added support to [fetch the content of the generated representation](./doc/files.md#get-representation-content) after it has been generated - Improved error messages for API response errors to allow for better debugging. ### [`v2.17.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2170-2018-04-10) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.16.1...v2.17.0) - Added support for assigning [Retention Policies to Metadata Templates](./doc/retention_policies.md#create-retention-policy-assignment) ### [`v2.16.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2161-2018-03-29) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.16.0...v2.16.1) - Added `CONTENT_ACCESS` to event type enum ### [`v2.16.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2160-2018-03-22) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.15.0...v2.16.0) - Added support for [user tracking codes](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxUser.Info.html#getTrackingCodes--) on the user object. - Fixed a bug where JWT authentication would fail due to improper date parsing. - Added support for setting custom headers on API connection. This allow for setting [As-User support](./doc/overview.md#as-user) and [suppressing notifications](./doc/overview.md/suppressing-notifications) support. - Changed default JWT expiration window to reduce chances of error. ### [`v2.15.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2150-2018-03-12) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.14.1...v2.15.0) - Added support for retrieving a [metadata template by ID](./doc/metadata_template.md#get-by-id) - Added support for allowing the user to [retrieve specific Collaboration fields on a Collaboration object](./doc/collaborations.md#get-a-collaborations-information) ### [`v2.14.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2141-2018-03-01) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.14.0...v2.14.1) - Reduced the number of API calls that the `EventStream` makes to fetch new events, which should help users who are running into rate limit issues. - Force support for TLSv1.1 or higher when available to improve the security of connections to the Box API - Add randomized jitter to the exponential backoff algorithm used by the SDK to improve the success rate of retried requests. ### [`v2.14.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2140-2018-02-15) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.13.0...v2.14.0) - Added support for getting and setting the `can_view_path` field on a collaboration object. - Added support for getting and setting the `tags` field on files and folders. ### [`v2.13.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2130-2018-02-07) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.12.0...v2.13.0) - Fixed an issue where all types of metadata values were being coerced to Strings. This change deprecates `Metadata#get()` in favor of type-specific methods like `Metadata#getFloat()` or a generic `Metadata#getValue()`, which returns a `JsonValue` object that represents any JSON type. See the [file metadata](./doc/files.md#get-metadata) or [folder metadata](./doc/folders.md#get-metadata) documentation for more information. ### [`v2.12.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2120-2018-02-01) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.11.0...v2.12.0) - Fixed ability to notify users or groups regarding [file collaboration](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#share-a-file) or [folder collaboration](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#share-a-folder) - Added [OAuth2 token creation event types](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxEvent.java#L747) - Added support for [inviting a user to another Box Enterprise](http://opensource.box.com/box-java-sdk/javadoc/com/box/sdk/BoxInvite.html) - Fixed an [OutOfMemory error in large file upload by capping the maximum number of parts that are uploaded concurrently](https://togithub.com/box/box-java-sdk/pull/543) ### [`v2.11.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2110-2018-01-25) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.10.0...v2.11.0) - [uploadLargeFile now returns a BoxFile object](https://togithub.com/box/box-java-sdk/pull/524) - [Fixed chunked upload for Box Files greater than 2GB](https://togithub.com/box/box-java-sdk/pull/531) - [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](https://togithub.com/box/box-java-sdk/pull/523) - BoxFolder.search has been deprecated in favor of [BoxSearch.searchRange](https://togithub.com/box/box-java-sdk/blob/86b82f2be3c57e3b89ae150b5f237d410e2d4900/doc/search.md) ### [`v2.10.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#2100-2018-01-11) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.9.0...v2.10.0) - [Add optional is_confirmed paramater for adding user email alias](https://togithub.com/box/box-java-sdk/pull/499) - Added support for [Metadata Template Delete](./doc/metadata_template#delete-a-metadata-template) ### [`v2.9.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#290-2018-01-04) - Added option to pass file [SHA-1 hash for upload integrity](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#upload-a-file) - Added support for [Terms of Service](./doc/terms_of_service) endpoint - Fixed missing [webhook triggers](https://togithub.com/box/box-java-sdk/pull/497) - Fixed missing [event types for events enum](https://togithub.com/box/box-java-sdk/pull/500) - Added [modified_at timestamp to BoxComment.Info](https://togithub.com/box/box-java-sdk/pull/499) - Added support for [Collaboration Whitelists](./doc/collaboration_whitelists) endpoint ### [`v2.8.2`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#282-2017-10-05) - Added additional check for `PrivateKeyInfo` in `BoxDeveloperEditionApiConnection` ### [`v2.8.1`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#281-2017-10-05) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.8.0...v2.8.1) - Added ability to [set connect and read timeout globally](https://togithub.com/box/box-java-sdk/pull/459) ### [`v2.8.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#280-2017-09-07) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.7.0...v2.8.0) - Added method for getting file representations - Changes to Representation object ### [`v2.7.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#270-2017-08-30) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.6.0...v2.7.0) - Added support for [Representations](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxFile.java#L445) endpoint ### [`v2.6.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#260-2017-08-28) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.5.0...v2.6.0) - Added support for [Batch](https://togithub.com/box/box-java-sdk/blob/575861fad0b3e67d432b5d5955d1e760b3f6444e/README.md#batchrequestexample) - Added support for [Unified Metadata](./doc/folders#get-metadata-using-unified-metadata-api) ### [`v2.5.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#250-2017-07-28) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.4.0...v2.5.0) - Added support for [Recent Items](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxRecents.java#L1) endpoint - Added support [Get All Groups By Name](https://togithub.com/box/box-java-sdk/blob/a1833950c18139fd9cbb4d8ee61d310c7bbedadf/src/main/java/com/box/sdk/BoxGroup.java#L143) endpoint - Added support for [Token Exchange](https://togithub.com/box/box-java-sdk/blob/main/src/main/java/com/box/sdk/BoxAPIConnection.java#L634) ### [`v2.4.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#240-2017-05-02) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.3.0...v2.4.0) - Support for multiput upload. New methods in BoxFolder and BoxFile support multiput upload for better performance and reliability for large files. - Single file collaborations. The BoxFile class now supports sharing individual files. - Automatic configuration for JWT auth. The Box Developer console now lets you download a JSON file of your JWT app configuration settings. You can import this file into the Java SDK to easily configure your app. ### [`v2.3.0`](https://togithub.com/box/box-java-sdk/blob/HEAD/CHANGELOG.md#230-2017-01-12) [Compare Source](https://togithub.com/box/box-java-sdk/compare/v2.1.1...v2.3.0) New API Endpoints: [Legal Holds](https://togithub.com/box/box-java-sdk/blob/main/doc/legal_holds.md) [Retention Policies](https://togithub.com/box/box-java-sdk/blob/main/doc/retention_policies.md) [Create Metadata Template](https://togithub.com/box/box-java-sdk/blob/main/doc/metadata_template.md#create-metadata-template) [Get All Metadata on File](https://togithub.com/box/box-java-sdk/blob/main/doc/files.md#get-all-metadata-on-file) [Get All Metadata on Folder](https://togithub.com/box/box-java-sdk/blob/main/doc/folders.md#get-all-metadata-on-folder) [Get Enterprise Metadata Templates](https://togithub.com/box/box-java-sdk/blob/main/doc/metadata_template.md#get-enterprise-metadata-templates) [Update Group](https://togithub.com/box/box-java-sdk/blob/main/doc/groups.md#update-a-group) [Watermarking](https://togithub.com/box/box-java-sdk/blob/main/doc/watermarking.md) [Webhooks V2](https://togithub.com/box/box-java-sdk/blob/main/doc/webhooks.md) [WebLinks](https://togithub.com/box/box-java-sdk/blob/main/doc/weblinks.md) [Collections](https://togithub.com/box/box-java-sdk/blob/main/doc/collections.md) [BoxGroupMembership with for Paging](https://togithub.com/box/box-java-sdk/blob/main/doc/groups.md) [Enterprise Device Pins](https://togithub.com/box/box-java-sdk/blob/86b82f2be3c57e3b89ae150b5f237d410e2d4900/doc/devices.md) New Features: Transactional Authentication. Support for Box's new Transactional Auth APIs. Upload file versions with SHA1. A file's SHA1 can be passed in to BoxFile.uploadVersion(...) when uploading new versions. Get effective_access for shared links. The effective_access field is accessible through BoxSharedLink. getEffectiveAccess(). Added additional Event Types. The TASK_ASSIGNMENT_COMPLETE, TASK_ASSIGNMENT_UPDATE, TASK_CREATE, COMMENT_DELETE types are now included in the BoxEvent class.