The 'Delete a folder' feature is as the name suggests to delete a new folder in a resource of your HydroShare account which would contain all the files you wish to discard along with it. Once deleted, you cannot retrieve them back. This feature is brought about by the HydroShare api Python library.
To try this on your own, you can use the code snippet below that is used in this demonstration.
from hs_restclient import HydroShare, HydroShareAuthBasic
auth = HydroShareAuthBasic(username='myusername', password='mypassword')
hs = HydroShare(auth=auth)
folder_to_delete = "folder_1/folder_2"
response_json = hs.deleteResourceFolder('ID OF RESOURCE GOES HERE', pathname=folder_to_delete)