Delete media folder
delete_media_folderRemove a media folder only when empty by default, or pass deleteContents to delete its assets. Use force to override the refusal that protects assets still referenced by pages, records or branding.
Instructions
Delete a media folder. By default only empty folders are removed; pass deleteContents to also delete the assets inside, and force to override the refusal that protects assets still in use.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "delete_media_folder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The folder id to delete | |
| force | No | When true, delete assets that pages, records or branding still reference. The refusal names those files. Requires the media:force-delete permission. | |
| deleteContents | No | When true, also delete the assets inside the folder. When false (default), deletion is refused if the folder is not empty. |