HomeGuidesExamplesAPI ReferenceChangelog
Log InWistia Learning CenterWistia
API Reference
Wistia Learning CenterWistia

List Deleted Media

get
https://api.wistia.com/modern/deleted_media

Lists media that has been soft-deleted and is still inside the account's
restore window. Media is listed only while it can still be restored — 30 days
on most plans, 14 on free plans. After which it is permanently purged.

Requires api token with one of the following permissions

Read all folder and media data

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
created with the all:delegate_to_contact_permissions scope and an
account authorization granting the manage-deleted-media permission can
also be used. Only the deleted media the token's media authorizations
name are listed.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
hashed_ids[]
array of strings

Restrict the results to the deleted media with these hashed IDs.

hashed_ids[]
string
enum

Field to order by. When omitted, results are ordered most-recently-deleted first.

Allowed:
integer
enum

Direction to order by. (0 = desc, 1 = asc; default is 1)

Allowed:
integer

The page number to retrieve. This cannot be combined with cursor,
pagination.

integer

The number of medias per page. Use this for both offset pagination and cursor pagination.

cursor
object

If cursor[enabled] is set to 1 then cursor pagination is enabled and the
first set of records are fetched up to the per_page. Cursor
pagination will also be turned on if cursor[before] or cursor[after]
are set. Records returned will have a cursor property set which can be used to fetch more records in the same sort_by ordering.
The cursor value of the last record can be used to fetch records after the current result set and
the cursor of the first record can be used to fetch records before the result set.

NOTE: a cursor value is only valid if the sort_by value hasn't changed from the
last fetch. For example, you cannot fetch using sort_by id and then pass that
cursor value to a sort_by name.

Headers
string
required
Defaults to 2026-09
Responses

Updated 4 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?