Update Video

put

https://{APP_DOMAIN}/api/3.2/contents/videos/{id}

Updates an existing video. The publication cannot be changed after creation. When active and show_on_website are both true, you must provide the ranks array with all videos for the publication to set display order.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

integer

required

The id of the video

Body Params

active

boolean

required

Whether the Video is active. Used to disable videos from being linked to if you know the url.

ranks

array of objects

Required when show_on_website is true. Array of {id, rank} entries for this video and its related videos.

ranks

title

string

required

The title of the video.

name

string

required

The internal name of the video.

description

string

Optional description of the video.

top_blurb

string

A blurb of information that is displayed above the video on client-facing websites.

bottom_blurb

string

A blurb of information that is displayed below the video on client-facing websites.

show_on_website

boolean

required

Whether the video is displayed on client-facing websites by default.

player

string

enum

required

The player used to play the video.

Allowed:

player_data

object

required

Data required to load the video from the selected player. For 'youtube'/'wistia' include video_id (10-11 chars). For 'video.js' include mp4 and webm URLs.

thumbnail_image_id

integer

required

ID of an image to be used as the video thumbnail.

publication_id

integer

required

The ID of the publication this video is being created for.

url_slug

string

Optional URL slug for the video.

tag_ids

array of integers

Array of tag IDs to associate with the video.

tag_ids

Response

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

application/json

200The updated video