HomeGuidesExamplesAPI ReferenceChangelog
Log InWistia Learning CenterWistia
API Reference
Wistia Learning CenterWistia

Update share link

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

Updates the share link for a single media. If the media does not have a
share link yet, one is created with the supplied visibility.

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
Body Params

Fields that can be set when updating a share link.

string
enum
required

Controls who can view the media via this share link.

  • unlocked: anyone with the link can view the media.
  • account: only signed-in members of the media's account can view.
  • locked: only contacts with access to the media's folder can view.
  • domain_verified: only viewers signed in with an email address at a
    domain verified on the media's account can view. Requires the account
    to be enrolled in the domain validation gate; otherwise setting this
    value returns 400.
Allowed:
Headers
Responses

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

Did this page help you?