---
title: "Delete Media"
method: DELETE
path: "/medias/{mediaHashedId}"
tags: ["Media"]
---

# Delete Media

`DELETE /medias/{mediaHashedId}`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/medias/{mediaHashedId}`
- Auth: HTTP bearer

Deletes a media. Deleted media moves to the account's Recently Deleted area,
where it can be restored until the account's restore window ends, after which
it is permanently purged.

## Requires api token with one of the following permissions
```
Read, update & delete anything
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

An [expiring access token](https://docs.wistia.com/reference/post_expiring-token)
created with the `all:delegate_to_contact_permissions` scope and an
authorization granting the `destroy` permission on this media can also be
used.

## Path parameters

- `mediaHashedId` string, required: Hashed ID of the media (e.g., "4d23503f70")

## Headers

- `X-Wistia-API-Version` string, required

## Response `200`

Successful deletion of the media.

- object: A media generally represents a video or an audio which can be embedded into your website. CDN-backed medias are accessible using this url structure: https://fast.wistia.com/embed/medias/{hashed_id}.m3u8. For more information, see https://docs.wistia.com/docs/asset-urls#getting-hls-assets.
  - `id` integer: A unique numeric identifier for the media within the system.
  - `name` string: The display name of the media.
  - `type` 'Video' | 'Audio' | 'Image' | 'PdfDocument' | 'MicrosoftOfficeDocument' | 'Swf' | 'UnknownType': A string representing what type of media this is.
  - `archived` boolean: Whether or not the media is archived, either true or false.
  - `created` string, date-time: The date when the media was originally uploaded.
  - `updated` string, date-time: The date when the media was last changed.
  - `duration` number, nullable: Specifies the length (in seconds) for audio and video files. Specifies number of pages in the document. Omitted for other types of media.
  - `embedCode` string: DEPRECATED: If you want to programmatically embed videos, follow the construct an embed code guide.
  - `hashed_id` string: A unique alphanumeric identifier for this media.
  - `description` string: A description for the media which usually appears near the top of the sidebar on the media's page.
  - `progress` number: A floating point value between 0 and 1 that indicates the progress of the processing for this file.
  - `status` 'queued' | 'processing' | 'ready' | 'failed': Post upload processing status. - `queued`: the file is waiting in the queue to be processed. - `processing`: the file is actively being processed. - `ready`: the file has been fully processed and is ready for embedding and viewing. - `failed`: the file was unable to be processed (usually a format or size error).
  - `section` string, nullable: The title of the section in which the media appears. This attribute is omitted if the media is not in a section (default).
  - `thumbnail` object
    - `url` string
    - `width` integer
    - `height` integer
  - `protected` boolean, nullable: Whether the media is protected (e.g. requires a password or other authentication to view). Null if the media is not protected.

## Other responses

- `401`: Unauthorized, invalid or missing token
- `403`: Forbidden, token is valid but account does not have access to feature
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-11-03** `b86cb2a7b420`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/medias/:mediaHashedId/delete.md)

---

[API](https://skmtc.dev/wistia/apis/data-api.md) - [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wistia/apis/data-api/revisions/b86cb2a7b420?raw)