Delete media
delete_mediaRemove one media file from a post group — e.g. a duplicate or never-uploaded slot that blocks scheduling with MEDIA_COUNT_EXCEEDED or media-not-ready errors. Find mediaIds via get_post (its 'media' array shows status per file). Deleting media from a scheduled post demotes it to draft; re-schedule with update_post afterwards.
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": {
"mediaId": "<mediaId>"
},
"name": "delete_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mediaId | Yes | MediaFile ID to delete (see the 'media' array in get_post) |