Skip to main content
DELETE
/
v2
/
folders
/
{folderId}
Delete Folder
curl --request DELETE \
  --url https://api.tusky.io/v2/folders/{folderId}
Delete a folder and optionally all files within it.

​
Path Parameters

​
folderId
string
required
The folder ID.

​
Query Parameters

​
recursive
boolean
default:"false"
If true, deletes all files and subfolders inside the folder. If false, the folder must be empty or the request returns 409 Conflict.

​
Response

Returns 204 No Content on success.

​
Example

curl -X DELETE "https://api.tusky.io/v2/folders/folder_xyz789?recursive=true" \
  -H "Api-Key: YOUR_API_KEY"
With recursive=true, all files and subfolders are permanently deleted. Files on Walrus remain until their storage epochs expire, but they are removed from your environment and no longer accessible through Tusky.