removeSecurityInfo
BooleanWrapper removeSecurityInfo(BaseBatchRequestDto)
DELETE /api/2.0/files/share
Remove sharing rights in batch
Revokes the access of every account and group on the files and folders listed in the request, and clears the entries from the caller's own favorites, recent and unread marks. The owner's own record is kept, since removing it would take the entry away from the account that owns it, and external links survive untouched - remove those through the link operations of the entry. The caller must be allowed to change the access of each entry, which means the creator of the room, a portal administrator, or a member with the rights to manage it; a caller whose only access came through an external link may use this call to drop the entry from its own list, while a directly invited member or an unrelated account is refused. The answer is always true and identifiers that match nothing are skipped silently, so a successful answer is not proof that anything was revoked - read the rights back with POST api/2.0/files/share. The call is destructive and safe to repeat. To take the rights of one account away instead of all of them, call PUT api/2.0/files/share with that account's access set to None.
Parameters
| Name | In | Type | Description | Notes |
|---|---|---|---|---|
| BaseBatchRequestDto | body | BaseBatchRequestDto | [optional] |
Responses
| Status code | Description | Type | Response headers |
|---|---|---|---|
| 200 | Always true: the accounts and groups that had access to the listed entries no longer have it | BooleanWrapper | X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset |
| 403 | The caller may not change the access of a listed entry and may not drop it from their own list either, because it was shared with them directly or they cannot read it | - | - |
| 500 | An id is a number that is not a 32-bit integer | - | - |
| 401 | Unauthorized | ErrorApiResponse | - |
| 429 | Too Many Requests. | ErrorApiResponse | Retry-After |
| 400 | Bad Request. | ErrorApiResponse | - |
| 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
Authorization
Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId
HTTP request headers
- Content-Type: application/json
- Accept: application/json