DELETE/media/{id}
Delete a media file with the PostEverywhere API
If the media is attached to scheduled posts the delete is refused with `409 media_in_use` unless `?force=true`, in which case those pending destinations are cancelled (marked failed with a cancellation note) and `cancelled_post_count` reports how many. 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