---
title: "Delete media by ID"
method: DELETE
path: "/v1/media/{id}"
tags: ["Media"]
---

# Delete media by ID

`DELETE /v1/media/{id}`

Permanently deletes an uploaded media item. Any scheduled or draft post still referencing it will fail to publish, so delete only media you know is unused.

## Path parameters

- `id` string, required

## Response `200`

Media item deleted successfully.

- DeleteEntityResponseDto
  - `success` boolean, required — Whether or not the entity was deleted

## Other responses

- `404` — Media not found based on the given ID.
- `500` — Internal server error when deleting the media.

---

[API](https://skmtc.dev/post-bridge/apis/post-bridge-api.md) · [All operations](https://skmtc.dev/post-bridge/apis/post-bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/post-bridge/post-bridge-api/revisions/97ae826701f6/schema)