Box UI Elements v13.0.0 released
Box UI Elements v13.0.0 released
13.0.0 (2021-04-22)
Bug Fixes & Features
This release fixes several bugs. For a full list, please see the release notes
Box iOS SDK v4.4.0 released
Box iOS SDK v4.4.0 released
Breaking Changes:
New Features and Enhancements:
- Add support for search parameter to get shared link items (#756)
- Add support for folder lock functionality (#759)
- Add support for
copyInstanceOnItemCopyfield for metadata templates (#763) - Add support for stream upload of new file versions and add support for 'If-Match' header when uploading new file versions (#766)
- Add additional details field for
Eventmodel (#770)
Bug Fixes:
Notice of behavior change for item download events
Notice of behavior change for item download events
Starting today, we will begin rolling out changes to the behavior of item download events when an application consumes those events from our event API endpoints.
This change will only affect the
ITEM_DOWNLOAD user event and will not affect existing
enterprise events. The new behavior will not cause
downtime within existing applications or require any application changes to
prevent uptime disruptions.
Change overview
Within the previous behavior when events were consumed, downloaded item
events were surfaced through the ITEM_DOWNLOAD event type for the owner of
the content as well as any contributors assigned to the content. This meant
that if a file with 2000 collaborators on it was downloaded, the file owner
plus all 2000 collaborators would have an event created stating that the file
was downloaded.
With the new behavior, notification of an item being downloaded will only be created for the owner of the content and will not be produced for collaborators. This will help to reduce the noise of the event stream while preserving the ability to see when items are downloaded as a content owner.
Where to get support
Should you have any issues or need further guidance, please post a request to our developer forum for any help needed.
New option for downscoping tokens using shared links
New option for downscoping tokens using shared links
When requesting an access token, you now have the ability to downscope that token to a file or folder using a shared link.
This new parameter may be used instead of using the resource parameter, which allows you to supply a file or folder ID to perform the same action.
Updates
- Added new
box_shared_linkrequest parameter to downscoping documentation. A shared link may be supplied to downscope an access token in the below way.
{
curl -i -X POST "https://api.box.com/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "subject_token=[ACCESS_TOKEN]" \
-d "subject_token_type=urn:ietf:params:oauth:token-type:access_token" \
-d "scope=item_upload item_preview base_explorer" \
-d "box_shared_link=https://cloud.box.com/s/123456" \
-d "grant_type=urn:ietf:params:oauth:grant-type:token-exchange"
}
- Added
box_shared_linkrequest parameter to request access token API reference.
New Metadata Query Indices Endpoint
New Metadata Query Indices Endpoint
A new API endpoint has been introduced to get a list of metadata query indices for a given template and scope.
Metadata queries provide a way to find files and folders by searching for the metadata attached to them.
When performing metadata queries on 10,000 or more files or folders,
non-performant queries may produce an HTTP 403 error.
Creating a search index delivers the ability to run
these queries at scale to bypass this error state, and are automatically applied
during the querying process.
The new endpoint permits the lookup of these created search indices.
Features
This release has introduced the following new content and features.
- New API endpoint to get a list of metadata query indices by scope and template.
- New metadata query index response object.
- New metadata query indices response object.
Updates
This release includes the following updated content.
- Updated metadata query indices guide to include details on how to get a list of metadata query indices.
Service Account email added to Developer Console
Service Account email added to Developer Console
Upon Admin authorization of an application leveraging server authentication,
the auto-generated email address of the Service Account is now surfaced in the
General tab of the Developer Console. This email address can then be used to
collaborate the user on Box content. The format will always be
AutomationUser_AppServiceID_RandomString@boxdevedition.com. For example,
AutomationUser_123456_6jCo6Pqwo@boxdevedition.com.
To learn more, see our guide on User Types and Service Accounts.
Features
- Added auto-generated email address of Service Account user to Developer Console
New Collection Events
New Collection Events
External collection events are now available via the enterprise events stream.
Collections in Box are a way to group files, folders, and web links without putting them all into a folder together. These new events provide a method for monitoring when collection actions are taken within an enterprise.
The events follow the standard event object schema, and include the following:
COLLECTION_CREATE: A collection was createdCOLLECTION_DELETE: A collection was deletedCOLLECTION_UPDATE: A collection was updatedCOLLECTION_ITEM_CREATE: An item was added to a collectionCOLLECTION_ITEM_DELETE: An item was removed from a collectionCOLLECTION_ITEM_UPDATE: An item in a collection was updated