POST videos/edit

Home / Solutions / POST videos/edit

POST videos/edit

Amends the information about a single video specified by the video_id, including title, description, category, pre-roll, post-roll and privacy settings.

Resource URL

https://zimovi.com/api/videos/edit.json (or .xml)

Resource Information

Required scope
admin
Required role
All
Response formats
JSON, XML
Requires authentication?
Yes

Parameters

video_id
required
The ID of the video for which to return results for.
title
optional
The title of the video.
preroll_video_id
optional
The id of the video pre-roll.
preroll_link
optional
The link of the video pre-roll
postroll_video_id
optional
The id of the video post-roll.
postroll_link
optional
The link of the video post-roll
privacy
optional
The privacy type of the video. Accepted values are public, protected and private.
description
optional
The description of the video.

Example Request

POST https://zimovi.com/api/videos/edit.json

Example Result

{
      "video":{
         "id":"cc2b8aecfaceca5c",
         "title":"ZiMovi Ad June 2015",
         "description":"New ZiMovi Ad June 2015 for our Launch Newsletter",
         "duration":"01:07",
         "created_at":"2015-06-16T11:42:31+00:00",
         "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/72244b9313b33580cdf793ff4983e1a6a720d8c5_6401.jpg",
         "width":"1920",
         "height":"1080",
         "privacy":"0",
         "page":"https:\/\/zimovi.com\/channel\/staff\/video\/cc2b8aecfaceca5c",
         "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/1360\" width=\"1280\" height=\"720\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>",
         "file_size":"144396548",
         "file_format":"mp4",
         "media_type":"QuickTime \/ MOV",
         "allow_comments":"1",
         "allow_embedding":"1"
      },
      "related_videos":{
         "video":[
            {
               "id":"0541aa577e2e59aa",
               "title":"New ZiMovi Promo June 2015 FINAL",
               "description":"New ZiMovi Promo June 2015 FINAL",
               "duration":"00:00",
               "created_at":"2015-06-26T16:31:23+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/397a47d98501896bf3cbfd660d585e0843a7906c_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/0541aa577e2e59aa",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/1393\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"a578edccac1feee9",
               "title":"Merry Christmas from ZiMovi ",
               "description":"Fun Festive animation from ZiMovi. Enjoy!\nZimovi is an innovative video platform. Channel owners can track and manage their video.\nChristmas animation project managed via GuruZi - Creative Marketplace. Animation produced by Mediaguru",
               "duration":"00:00",
               "created_at":"2014-12-23T17:37:30+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/37b9ef0d97c802839dc24d80ba1f6ed79c1b41d9_6402.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/a578edccac1feee9",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/841\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"9be1415bedb89e85",
               "title":"ZiMovi Trailer",
               "description":"Short promotional trailer, introducing ZiMovi's key features.",
               "duration":"00:00",
               "created_at":"2014-07-29T10:45:26+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/22d0c5889f86ad2a6fa3a0ce268ec031cbc82ee0_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/9be1415bedb89e85",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/343\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"bcc2f1c6656df087",
               "title":"New ZiMovi Main Animation",
               "description":"ZiMovi is an innovative video platform that allows you to take complete control of your Brand Protection, Data Analysis and Monetisation. ",
               "duration":"00:00",
               "created_at":"2014-07-31T12:44:20+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/91b4ebba9a384531647efc60e7bf13213c1d8a0e_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/bcc2f1c6656df087",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/354\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"ac790aac7f051e83",
               "title":"New ZiMovi Promo Animation - Draft",
               "description":"New ZiMovi Promo Animation - Draft",
               "duration":"00:00",
               "created_at":"2015-04-28T12:00:06+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/41b62a00d9a84a9096185a38e50782f79a7aceeb_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/ac790aac7f051e83",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/1166\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"e86ccc415e3cb46a",
               "title":"ZiMovi New - Video Producers Story - Draft - no music",
               "description":"ZiMovi New - Video Producers Story - Draft - no music",
               "duration":"00:00",
               "created_at":"2015-04-28T15:54:33+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/eca30917c37c78dc71349231a56b733e553b1772_6402.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/e86ccc415e3cb46a",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/1168\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"0a65107a52102b5d",
               "title":"ZiMovi",
               "description":"Future-proof your online video investment by partnering with an industry-innovator that is continually bringing something new to your digital world. Provides a highly-scalable, secure video hosting platform.\n\nZiMovi is a _product first_ company, and we believe only remarkable product can form the basis of a great company.\n",
               "duration":"00:00",
               "created_at":"2014-06-02T20:02:59+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/5fba4e64f306534920e7e37fc00afcbe1a9b0016_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/0a65107a52102b5d",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/148\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"d4ac1f9b55da0317",
               "title":"ZiMovi Logo",
               "description":"Short animation of the ZiMovi Logo",
               "duration":"00:00",
               "created_at":"2014-06-08T01:45:00+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/6e7060b77a48ac36da06b5e29d0654c6466d69ad_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/d4ac1f9b55da0317",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/162\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"ec700a7d7ef2d78f",
               "title":"ZiMovi Video Manager",
               "description":"Core features of ZiMovi video manager",
               "duration":"00:00",
               "created_at":"2014-06-11T18:36:26+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/c2e4f52d74d85a525d74137f964b0929ed1445bc_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/ec700a7d7ef2d78f",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/186\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            },
            {
               "id":"36d5b48755a27ecc",
               "title":"The Channel",
               "description":"Hello and welcome to the ZiMovi video guide to your channel. From this menu you can set out exactly how you want your channel to look. Click on the Details and Appearance and you can change the title, description and category of your Channel.\n\nYou can specify the colours you\u2019d like for your links, text and background as well as adding your logo and own background header image. Your channel will look exactly as you want it to look in just a few clicks. From this page you can also specify what playlists you would like to be shown on your channel and you can decide if you want to turn on or off various functions.\n\nOnce you\u2019ve made your changes - click on the View My Channel button and your channel will open in another window - so you can see what your changes look like. Go to the monetisation ZiMovi video guide to find out how you can make money from your channel.",
               "duration":"00:00",
               "created_at":"2014-07-17T20:43:05+00:00",
               "poster":"\/\/d1teylh2i3wa1w.cloudfront.net\/videos\/bd1781cb809a4d949cb135f84953fdee9badfeab_640.jpg",
               "width":null,
               "height":null,
               "privacy":"0",
               "page":"https:\/\/zimovi.com\/channel\/staff\/video\/36d5b48755a27ecc",
               "player":"<iframe src=\"https:\/\/zimovi.com\/channel\/staff\/player\/video\/297\" width=\"560\" height=\"315\" frameborder=\"0\" webkitallowfullscreen mozallowfullscreen allowfullscreen><\/iframe>"
            }
         ]
      },
      "activities":{
         "views":{
            "view":[
               {
                  "id":"55f2c06cc621f6cde2685f12",
                  "video":{
                     "id":"cc2b8aecfaceca5c",
                     "title":"ZiMovi Ad June 2015",
                     "page":"https:\/\/zimovi.com\/channel\/staff\/video\/cc2b8aecfaceca5c\/511cced7b57a0527b4cef82a0a680c6c",
                     "domain":"zimovi.com",
                     "is_embed":false
                  },
                  "progress":{
                     "length":5.02,
                     "last_view":"2015-09-11T11:53:01+00:00",
                     "view_count":1
                  },
                  "device":{
                     "platform":"Windows",
                     "browser":"MSIE",
                     "version":"11.0"
                  },
                  "viewer":{
                     "is_user":false,
                     "ip":"82.242.168.122",
                     "country":"FR",
                     "geolocation":null
                  }
               },
               {
                  "id":"55f2beefc621f6cde2685f0f",
                  "video":{
                     "id":"cc2b8aecfaceca5c",
                     "title":"ZiMovi Ad June 2015",
                     "page":"https:\/\/zimovi.co.uk\/channel\/staff\/video\/cc2b8aecfaceca5c",
                     "domain":"zimovi.co.uk",
                     "is_embed":false
                  },
                  "progress":{
                     "length":2.52,
                     "last_view":"2015-09-11T13:49:02+00:00",
                     "view_count":1
                  },
                  "device":{
                     "platform":"Windows",
                     "browser":"Chrome",
                     "version":"44.0.2403.157"
                  },
                  "viewer":{
                     "is_user":true,
                     "user_id":"75d4533191ca6bc3",
                     "name":"Staff ZiMovi",
                     "email":"info@zimovi.com",
                     "ip":"89.145.196.97",
                     "country":"GB",
                     "geolocation":{
                        "type":"Point",
                        "coordinates":[
                           51.5307,
                           0.0999
                        ]
                     }
                  }
               },
               {
                  "id":"55f2b62fc621f6cde2685f02",
                  "video":{
                     "id":"cc2b8aecfaceca5c",
                     "title":"ZiMovi Ad June 2015",
                     "page":"https:\/\/zimovi.com\/channel\/staff\/video\/cc2b8aecfaceca5c",
                     "domain":"zimovi.com",
                     "is_embed":false
                  },
                  "progress":{
                     "length":13.43,
                     "last_view":"2015-09-11T11:08:44+00:00",
                     "view_count":1
                  },
                  "device":{
                     "platform":"Windows",
                     "browser":"Chrome",
                     "version":"44.0.2403.157"
                  },
                  "viewer":{
                     "is_user":false,
                     "ip":"89.145.196.97",
                     "country":"GB",
                     "geolocation":{
                        "type":"Point",
                        "coordinates":[
                           51.5307,
                           0.0999
                        ]
                     }
                  }
               },
               {
                  "id":"55eb7b1ec621f6cde2685752",
                  "video":{
                     "id":"cc2b8aecfaceca5c",
                     "title":"ZiMovi Ad June 2015",
                     "page":"https:\/\/zimovi.com\/channel\/staff\/video\/cc2b8aecfaceca5c\/511cced7b57a0527b4cef82a0a680c6c",
                     "domain":"zimovi.com",
                     "is_embed":false
                  },
                  "progress":{
                     "length":38.56,
                     "last_view":"2015-09-05T23:28:18+00:00",
                     "view_count":1
                  },
                  "device":{
                     "platform":"Macintosh",
                     "browser":"Chrome",
                     "version":"45.0.2454.85"
                  },
                  "viewer":{
                     "is_user":false,
                     "ip":"86.150.53.115",
                     "country":"GB",
                     "geolocation":null
                  }
               },
               {
                  "id":"55ddc595c621f6cde2685415",
                  "video":{
                     "id":"cc2b8aecfaceca5c",
                     "title":"ZiMovi Ad June 2015",
                     "page":"https:\/\/zimovi.co.uk\/channel\/staff\/video\/cc2b8aecfaceca5c",
                     "domain":"zimovi.co.uk",
                     "is_embed":false
                  },
                  "progress":{
                     "length":7.84,
                     "last_view":"2015-08-26T13:54:16+00:00",
                     "view_count":1
                  },
                  "device":{
                     "platform":"Macintosh",
                     "browser":"Firefox",
                     "version":"39.0"
                  },
                  "viewer":{
                     "is_user":true,
                     "user_id":"75d4533191ca6bc3",
                     "name":"Staff ZiMovi",
                     "email":"info@zimovi.com",
                     "ip":"86.187.74.70",
                     "country":"GB",
                     "geolocation":{
                        "type":"Point",
                        "coordinates":[
                           53.3703,
                           -1.4916
                        ]
                     }
                  }
               }
            ]
         },
         "comments":{
            "comment":[
               {
                  "id":"55fb0fb6e6ec3f7c67bbea6d",
                  "video":{
                     "id":"cc2b8aecfaceca5c",
                     "title":"ZiMovi Ad June 2015",
                     "page":"https:\/\/zimovi.com\/channel\/staff\/video\/cc2b8aecfaceca5c",
                     "domain":"zimovi.com"
                  },
                  "device":{
                     "platform":"Macintosh",
                     "browser":"Firefox",
                     "version":"40.0"
                  },
                  "content":"New Corp video coming soon",
                  "status":"published",
                  "created_at":"2015-09-17T19:08:38+00:00",
                  "author":{
                     "is_user":true,
                     "user_id":"876f802ab546b8c7",
                     "name":"Alex Zang",
                     "photo":"\/\/d1teylh2i3wa1w.cloudfront.net\/users\/avatar_0cbe29e3f6098553a013b9c835e1cd43292cf035_normal.jpg",
                     "ip":"86.153.203.242",
                     "country":"GB",
                     "geolocation":{
                        "type":"Point",
                        "coordinates":[
                           53.3416,
                           -1.5214
                        ]
                     }
                  }
               },
               {
                  "id":"55ddc5058e632b5948f0d352",
                  "video":{
                     "id":"cc2b8aecfaceca5c",
                     "title":"ZiMovi Ad June 2015",
                     "page":"https:\/\/zimovi.co.uk\/channel\/staff\/video\/cc2b8aecfaceca5c",
                     "domain":"zimovi.co.uk"
                  },
                  "device":{
                     "platform":"Macintosh",
                     "browser":"Firefox",
                     "version":"39.0"
                  },
                  "content":"Watch stuff happen with ZiMovi. ",
                  "status":"published",
                  "created_at":"2015-08-26T13:54:13+00:00",
                  "author":{
                     "is_user":true,
                     "user_id":"75d4533191ca6bc3",
                     "name":"Staff ZiMovi",
                     "photo":"\/\/d1teylh2i3wa1w.cloudfront.net\/users\/avatar_47f9595fa695065d26f2f97cd14851c2f50e8436_normal.png",
                     "ip":"86.187.74.70",
                     "country":"GB",
                     "geolocation":{
                        "type":"Point",
                        "coordinates":[
                           53.3703,
                           -1.4916
                        ]
                     }
                  }
               }
            ]
         }
      }
}
Contact Us

We're not around right now. But you can send us an email and we'll get back to you, asap.

Not readable? Change text. captcha txt