---
title: "Changes to Delete the specified media item"
method: DELETE
path: "/media/{id}/"
---

# Changes to Delete the specified media item

`DELETE /media/{id}/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 8 revisions.

- **2026-03-18** `e271d0e41f6d`: 1 breaking, 1 warning, 5 info
- **2026-03-06** `0f490cfb7931`: 7 info
- **2026-03-05** `6b68c4d49c45`: 1 info
- **2026-02-03** `fc0a40f3b859`: 1 breaking

## Changes

- **2026-03-18** `e271d0e41f6d`: 1 breaking, 1 warning, 5 info
  - the `success` response's property type changed from `string` to `boolean` for status `200`
  - deleted the `path` request parameter `id`
  - api operation id `delete_media_id_` removed and replaced with `deleteMediaId`
  - the endpoint scheme security `XF-Api-Key` was added to the API
  - the endpoint scheme security `XF-OAuth2` was added to the API
  - added the new optional `header` request parameter `XF-Api-User` to all path's operations
  - added the new optional `query` request parameter `api_bypass_permissions` to all path's operations
- **2026-03-06** `0f490cfb7931`: 7 info
  - api tag `Media` added
  - api tag `media` removed
  - added the new optional `query` request parameter `author_alert`
  - added the new optional `query` request parameter `author_alert_reason`
  - added the new optional `query` request parameter `hard_delete`
  - added the new optional `query` request parameter `reason`
  - added the media type `application/json` for the response with the status `200`
- **2026-03-05** `6b68c4d49c45`: 1 info
  - endpoint added
- **2026-02-03** `fc0a40f3b859`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/docs/media/:id/delete.md) - [API](https://skmtc.dev/xenforo-ltd/apis/xenforo-api.md) - [Page](https://skmtc.dev/xenforo-ltd/apis/xenforo-api/changes/media/:id/delete)