royal-mcp__wp_delete_media
Delete a media item. With the WordPress media trash on (MEDIA_TRASH in wp-config.php) it moves to the trash and the reply carries an undo token. With the media trash off, or for an item already in the trash, a delete removes the files for good, so it is refused unless force: true; force: true always deletes permanently, with no undo. (site: demo.royalplugins.com) Through Royally: waits for a person to approve it in Royally; nothing on the site changes until then.
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": "royal-mcp__wp_delete_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| force | No | Delete permanently, files included. There is no undo. | |
| site_id | No | Site to run this tool on: 8ef2e52b-bd07-4671-a363-ebe8b480b65c (https://demo.royalplugins.com) |