Changelog
2.3.0 [2019-05-23]
--confirm
flag to the box users:email-aliases:add
command to automatically confirm the email alias--restrict-to-enterprise
flag to the box folders:update
command to restrict collaboration on the folder
to the owner's enterprisebox folders:update
command where the --upload-email-access
flag would not correctly set
the folder upload email access levelChangelog
2.2.0 [2019-04-30]
--sort
and --direction
flags to box search
to control the sort order of the search resultsbox collections:add
to work correctly with web_link
itemsbox folders:collaborations:add
could incorrectly interpret bulk
input entries and produce unintended API requestsbox folders:metadata:set
and box files:metadata:set
commands to apply metadata keys and values, overwriting
existing metadata under those keysChangelog
2.1.0 [2019-03-28]
--fields
flag was not always requesting additional fields from the API--event-types
flag for the box events
and box events:poll
commandslodash@4.17.11
to address a potential prototype pollution vulnerabilitybox events
and box events:poll
commands:
box events
command now requires either a closed date range (defaults to last five days), or a stream
position. If given a date range, all events in that range will be returned. If given a stream position,
up to limit
events will be returned along with the next stream positionbox events:poll
now correctly polls for new eventsChangelog
2.0.0 [2018-12-13]
--fields
. All commands that output collections of objects no longer require interactive key presses
to view all objects.1535336043
), with a
year offset shorthand (e.g. -1y
for "one year ago"), and as a combination of offset shorthands (e.g. -5h30m
for
"5 minutes and 30 seconds ago")--save
and --save-to-file-path
flags to save the output to disk. The output written will respect the --json
and --csv
flags for specifying
output format, otherwise it will use the file format in the CLI settings.box request
command allows making any API call against the Box API, and can be used
to pass arbitrary URLs and parametersbox configure:environments:update --no-cache-tokens
box autocomplete
command, which will help you set up autocompletion (currently available only in bash and zsh
shells)box configure:environments:select
) can now be called without
providing the necessary arguments; in this case, the command will display a helpful prompt to allow selecting the
argument value.box files:shared-links:create
is now box files:share
— 14 characters shorter! Most
commands that were previously available as xyzs:list
are now just xyzs
; for example,
box folders collaborations list
is now box folders:collaborations
--destination
flag to have the files or
folders download to any locationbox files:metadata:*
, box folders:metadata:*
, and box metadata-templates:*
command interfaces have changed;
please run the commands with --help
for more detailsbox sessions
commands have been removed; use box configure:environments:switch-user [USER_ID]
to switch
between users.box configure settings
subcommands have been removed; these settings can be set by passing the appropriate
flag(s) to box configure:settings
box files shared-links get [fileID]
is replaced by box files:get [fileID] --fields=shared_link
(output format differs)box folders shared-links get [folderID]
is replaced by box folders:get [folderID] --fields=shared_link
(output format differs)box folders change-upload-email [folderID] [access]
is replaced by
box folders:update [folderID] --upload-email-access=[access]
(output format differs)box storage-policies assignments add [userID] [policyID]
is replaced by
box storage-policies:assign [policyID] [userID]
(same functionality, may make more API calls)box storage-policies assignments update [assignmentID] [policyID]
is deprecated in favor of
box storage-policies:assign [policyID] [userID]
box users change-primary-email [userID] [email]
is replaced by box users:update [userID] --login=[email]
(output format differs)--list-members flag
has been removed from the box groups:membership:list
command; this is now the default
behavior of the command and does not need to be specified via flag.--list-groups
flag on box groups:membership:list
has been removed; this functionality is now found in
the box users:groups
command.--list-collaborations
flag on box groups:membership:list
has been removed; this functionality is now found
in the box groups:collaborations
command.-r|--role
flag in box collaborations:add
and similar commands
are now separated by an underscore (e.g viewer_uploader
) instead of a space. This should make it easier to work
with these commands without needing to quote the flag value.-y|--yes
flag has been removed from some commands; deletions of users, folders, files, etc will no longer
prompt to confirm that the item should be deleted.-m|--multi
flag has been removed from box files:download
and box folders:download
since these commands
now accept bulk input via CSV.--id-only
flag has been removed from box folders:move
, since a folder move within a user's account should
not change the folder ID.--parent-folder-id
flag has been removed from the box folders:update
command; users should use
box folders:move
instead.--shared-link-*
flags have been removed from the box folders:update
command; users should use
box folders:share
instead.--sync-disable
flag on box users:create
and box users:update
is now called --no-sync-enable
--is-exempt-from-device-limits
flag on box users:create
and box users:update
is now called
--exempt-from-device-limits
--not-exempt-from-device-limits
flag on box users:create
and box users:update
is now called
--no-exempt-from-device-limits
--is-exempt-login-verification
flag on box users:create
and box users:update
is now called
--exempt-from-2fa
--not-exempt-login-verification
flag on box users:create
and box users:update
is now called
--no-exempt-from-2fa
--parent-folder
flag on box files:upload
is now called --parent-id
for consistency with other commandsbox storage-policies:assign
command no longer takes two arguments (a type and ID), and instead now takes
one argument (the ID) and has a --type
flag with default value "user" to make the command easier to run for common
use casesbox webhooks:create
command no longer takes four arguments (target type, target ID, triggers, and URL), but
instead now takes two arguments (the target type and ID) and has two new flags: --triggers
and --address
to make
it easier to specify without needing to remember the argument order--limit
flag on box users:list
and box collaborations:list-for-group
has been removed; all results will
be returned by defaultbox users:create --status
flag was changed from -s
to -S
to disambiguate from the
global --save
flagbox webhooks:update --triggers
flag was changed from -t
to -T
to disambiguate from
the global --token
flagbox collaborations:add
has changed; see --help
for more details--json
flag in the search command works correctly now\MyFolder\file.pdf
) now work correctly