Update a video's metadata
PATCH {{baseUrl}}/videos/:id
This operation updates a video's metadata. To replace the video file, use the PUT /video/ID.
Request Body
{"video"=>{"name"=>"My video", "description"=>"A new video for my business.", "unpublish"=>true, "unpublished_at"=>"2025-01-01T12:33:22Z", "published"=>false, "published_at"=>"2024-01-01T12:33:22Z", "tags"=>["foo", "bar"], "category_id"=>"<The account's default category>", "no_ads"=>true, "ad_keywords"=>"special_ads"}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"video":{"id":"2aa3343e-2fb5-42c3-8671-b52c24b7c3e2","name":"My video","description":"A new video for my business.","duration_in_ms":-48292169,"unpublish":true,"unpublished_at":"2025-01-01T12:33:22Z","published":true,"published_at":"2024-01-01T12:33:22Z","tags":["foo","bar"],"category_id":"\u003cThe account's default category\u003e","no_ads":true,"ad_keywords":"special_ads","created_at":"2024-01-01T12:33:22Z","updated_at":"2024-01-01T12:33:22Z","state":"FINISHED","encoding_progress":97289213.77528757,"upload_progress":48996963.713496655,"error_message":"qui consectetur","deactivated":false,"images":[{"type":"image_2","url":"https://example.com/image.jpg"},{"type":"image","url":"https://example.com/image.jpg"}],"encodings":[{"audio_bitrate_in_kbps":2300,"audio_channel":2,"audio_codec":"aac","audio_sample_rate":44100,"height":1080,"width":1920,"video_file_url":"https://flowplayer.com/video.mp4","video_container":"mp4","video_codec":"h264","total_bitrate_in_kbps":1023,"created_at":"2002-02-24T03:05:25.088Z","size_in_bytes":8325555},{"audio_bitrate_in_kbps":2300,"audio_channel":2,"audio_codec":"aac","audio_sample_rate":44100,"height":1080,"width":1920,"video_file_url":"https://flowplayer.com/video.mp4","video_container":"mp4","video_codec":"h264","total_bitrate_in_kbps":1023,"created_at":"2007-11-22T01:07:35.410Z","size_in_bytes":8325555}],"drm":{"com.widevine.alpha":{"license_server":"dolor amet","certificate":"in officia"},"com.apple.fps.1_0":{"license_server":"ad","certificate":"et in Lorem"},"com.microsoft.playready":{"license_server":"ipsum ullamco","certificate":"ea ut"}},"shallow_copy":true,"shallow_copy_source_id":"minim","multiple_audio_tracks":true,"audio_only":false,"version":68849971,"thumbnails":{"src":"adipisici"},"animated_previews":[{"url":"aliqua quis","type":"fugia","height":1080,"width":1920},{"url":"et reprehenderit","type":"et non","height":1080,"width":1920}]}}