deleteRecent
deleteRecent(BaseBatchRequestDto)
DELETE /api/2.0/files/recent
Delete recent files
Removes the listed entries from the Recent section of the calling account, the history of opened files that GET api/2.0/files/recent returns. Nothing is deleted from storage and no other member's history is touched; access to the entries is not checked at all, so a file the caller can no longer read can still be cleared from their own history. Only numeric file ids are honoured, so a file on a connected third-party account cannot be cleared this way, and folder ids are accepted but change nothing because the section lists files only. The answer carries no body and reports nothing about how many entries were found: an empty request and an id that was never in the section are accepted alike. Repeating the call is safe, but an entry returns the next time the file is opened or POST api/2.0/files/file/{fileId}/recent is called for it. To hide the whole section instead, call PUT api/2.0/files/displayrecent.
Parameters
| Name | In | Type | Description | Notes |
|---|---|---|---|---|
| BaseBatchRequestDto | body | BaseBatchRequestDto | [optional] |
Responses
| Status code | Description | Type | Response headers |
|---|---|---|---|
| 200 | Empty answer: the listed entries no longer appear in the Recent section | - | X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset |
| 400 | The request body cannot be read, or a third-party folder identifier refers to a storage account that is not connected | - | - |
| 404 | A third-party folder identifier names a storage type the portal does not know | - | - |
| 500 | An id is a number that is not a 32-bit integer, or a third-party folder identifier carries a storage account number beyond the 32-bit range | - | - |
| 401 | Unauthorized | ErrorApiResponse | - |
| 429 | Too Many Requests. | ErrorApiResponse | Retry-After |
| 502 | Bad Gateway. Returned by the reverse proxy, response body may be HTML and not JSON. | - | - |
| 503 | Service Unavailable. Returned by the reverse proxy, response body may be HTML and not JSON. | - | - |
Return type
null (empty response body)
Authorization
Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId
HTTP request headers
- Content-Type: application/json
- Accept: application/json