DELETE/media/{id}
Delete a media file with the PostEverywhere API
If the media is attached to posts that have not gone out yet, the delete is refused with `409 media_in_use` and nothing is deleted. With `?force=true` the file is deleted and those pending destinations are cancelled (marked failed with a cancellation note), so they never publish; `cancelled_post_count` reports how many. The MCP tool `delete_media` has a `force` option for this. Deletion is permanent and frees storage. Fires the `media.deleted` webhook event.
Guide: Media requirements by platform
Parameters
| id | string | required | Media UUID |
| force | boolean | optional | Set to true to confirm deletion when the media is attached to scheduled posts |
Responses
- 200Deleted
- 400
- 401
- 402
- 403
- 404
- 409Media attached to scheduled posts — retry with force=true
- 429
- 500