# Delete a media file (/en/reference/media/delete-media)

OpenAPI operation (components in https://api.tebar.app/v1/openapi.json):

```json
[
  {
    "operationId": "deleteMedia",
    "tags": [
      "Media"
    ],
    "summary": "Delete a media file",
    "description": "Used by an unfinished post (draft, scheduled, publishing): 409 media_in_use. Used by finished posts: the file is removed and the media becomes expired.\n\nRequires the write scope.",
    "parameters": [
      {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      {
        "$ref": "#/components/parameters/TebarProfile"
      }
    ],
    "responses": {
      "204": {
        "description": "Done, no body."
      },
      "401": {
        "$ref": "#/components/responses/Unauthorized"
      },
      "403": {
        "$ref": "#/components/responses/Forbidden"
      },
      "404": {
        "$ref": "#/components/responses/NotFound"
      },
      "429": {
        "$ref": "#/components/responses/RateLimited"
      }
    }
  }
]
```