HomeGuidesExamplesAPI ReferenceChangelog
Log InWistia Learning CenterWistia
API Reference
Wistia Learning CenterWistia

Update Media

put
https://api.wistia.com/modern/medias/

Updates the attributes on a media.

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
created with the all:delegate_to_contact_permissions scope and an
authorization granting the update permission on this media can also be
used.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requestsā€¦
LoadingLoadingā€¦
Path Params
string
required

The hashed ID of the media.

Body Params
string

The mediaā€™s new name.

string

The Wistia hashed ID of an image that will replace the still thatā€™s displayed before the player starts playing.

string

A new description for this media. Accepts plain text or markdown.

tags
array of strings

An array of tag names to apply to the media. This replaces any existing tags. To add tags without replacing existing tags, use bulk-tag-media.

tags
custom_metadata
object

Custom metadata field values to set, keyed by field key. Values take the
same shapes as the Set Custom Metadata Field Value endpoint; a null value
clears that field and omitted fields are untouched. Requires the custom
metadata feature on the account.

Headers
string
required
Defaults to 2026-09
Responses

Updated 6 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 6 months ago

Did this page help you?