---
title: "Delete a media file"
method: DELETE
path: "/media/{id}"
tags: ["Media"]
---

# Delete a media file

`DELETE /media/{id}`

## Path parameters

- `id` string, required

## Response `204`

Media deleted

## Other responses

- `404` — Media not found
- `409` — Media is attached to a scheduled or publishing post and cannot be deleted yet (error code `media_in_use`). Cancel or reschedule the post(s) first, otherwise deleting the file would make the post fail to publish.

---

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