跳到主要内容

changeAutomaticallyCleanUp

AutoCleanUpDataWrapper changeAutomaticallyCleanUp(AutoCleanupRequestDto)

PUT /api/2.0/files/settings/autocleanup

Update the trash bin auto-clearing setting

Writes the trash auto-clearing setting of the calling account and returns the pair that is now stored. Both fields are written together from the request, so a call that omits gap stores an interval outside the published list rather than keeping the previous one - always send the interval, including when set is false. While clearing is on, an item is removed from the caller's trash for good once it has been there longer than the interval, and each trashed entry reports the moment it is due to disappear in its own autoDelete field; switching clearing off stops that and leaves whatever is in the trash. The setting belongs to the calling account alone: every authenticated role down to a guest may change its own, one member's choice never affects another, and an unauthenticated caller is refused. Items already removed are not recoverable. Read the pair back with GET api/2.0/files/settings/autocleanup.

Parameters​

NameInTypeDescriptionNotes
AutoCleanupRequestDtobodyAutoCleanupRequestDto[optional]

Responses​

Status codeDescriptionTypeResponse headers
200The trash auto-clearing setting that is now stored for the callerAutoCleanUpDataWrapperX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
401UnauthorizedErrorApiResponse-
429Too Many Requests.ErrorApiResponseRetry-After
500Internal Server Error.ErrorApiResponse-
400Bad Request.ErrorApiResponse-
502Bad Gateway. Returned by the reverse proxy, response body may be HTML and not JSON.--
503Service Unavailable. Returned by the reverse proxy, response body may be HTML and not JSON.--

Return type​

AutoCleanUpDataWrapper

Authorization​

Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json