Skip to main content
PATCH
Update account data-retention policy

Authorizations

Authorization
string
header
required

Box bearer token in the form box_.... Service API keys authenticate Box operations.

Body

application/json
enabled
boolean
required
confirmation
string

Required when enabling and must exactly equal delete archived box data.

Allowed value: "delete archived box data"

Response

Updated retention policy. Responses are never cached.

ok
boolean
required
Example:

true

type
enum<string>
required

Stable success envelope discriminator added by v1.

Available options:
data_retention.info,
data_retention.updated
enabled
boolean
required
enabledAt
string<date-time> | null
required
queuedBoxes
integer

Archived Boxes newly queued for deletion by this policy update.

Required range: x >= 0
acceptedDeletionOperationsIrreversible
boolean

Always true on updates. Disabling the policy does not cancel accepted deletion operations.