Delete media
delete_mediaMove media assets to the trash for 30-day restoration; assets still in use are refused unless force is set, and unknown IDs are skipped.
Instructions
Move media assets to the trash. They can be restored in the cmssy admin for 30 days, after which they are deleted permanently. Assets still in use are refused unless force is set. Ids not found in this workspace are skipped, so compare deleted with requested.
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": {
"ids": "<ids>"
},
"name": "delete_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | The asset ids to delete, from list_media. At most 100 per call. | |
| force | No | When true, also trash assets that pages, records or branding still reference; those references lose the file until it is restored. The refusal names those files. Requires the media:force-delete permission. |