{"__v":1,"_id":"56d46a5b8001e30b00896ebb","category":{"__v":12,"_id":"564df3217c8f372b00b934df","pages":["564e01de8980c32b009e8bca","564e031f5eab6e0d0069ca38","564e057a873c362d005172b2","564e05a15eab6e0d0069ca40","564e07b01494cc2b00acb618","56941291d8c04d1700e5adc2","5696aca1cb14e11700f8aa01","56d46a4f73dcd20b00fb8647","56d46a5b8001e30b00896ebb","56f00bd1d58ed32400df6092","56f01568d58ed32400df60c1","56f0194911415c2900969c10"],"project":"564de2dbfe07a81700b5c3a5","version":"564de2dbfe07a81700b5c3a8","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-11-19T16:04:49.459Z","from_sync":false,"order":0,"slug":"api","title":"API"},"editedParams":true,"editedParams2":true,"parentDoc":null,"project":"564de2dbfe07a81700b5c3a5","user":"569e9cb9c237d225002df59b","version":{"__v":10,"_id":"564de2dbfe07a81700b5c3a8","project":"564de2dbfe07a81700b5c3a5","createdAt":"2015-11-19T14:55:23.838Z","releaseDate":"2015-11-19T14:55:23.837Z","categories":["564de2ddfe07a81700b5c3a9","564df317826645210097a890","564df3217c8f372b00b934df","564e5227c3553e0d003e53ba","5666dac5d784a70d00397bcb","56cd08ddd98d851d00c0c3bd","56e9a50946bfd60e008840a7","5718e37bf8f7de1900683fad","58c3308dfedf070f0043b72c","58ce99c75457d02300560c0a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":["571179e65542ed0e002da683"],"next":{"pages":[],"description":""},"createdAt":"2016-02-29T15:57:15.492Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"post","results":{"codes":[{"name":"","code":"{'error': false, 'video_id': '12345'}","language":"json","status":200},{"name":"","code":"{'error': true, 'error_message': 'Please ensure video exists or you have ownership.'}","language":"json","status":403},{"code":"{'error': true, 'error_message': 'Invalid API key.'}","language":"json","status":400}]},"settings":"569412f63e9d080d00f064fe","auth":"required","params":[{"_id":"56d46a4f73dcd20b00fb864c","ref":"","in":"body","required":true,"desc":"The id of the video to update","default":"","type":"string","name":"video_id"},{"_id":"56d46a4f73dcd20b00fb864b","ref":"","in":"body","required":false,"desc":"A title for video","default":"","type":"string","name":"title"},{"_id":"56d46a4f73dcd20b00fb864a","ref":"","in":"body","required":false,"desc":"A description for video","default":"","type":"string","name":"description"},{"_id":"56d46a4f73dcd20b00fb8649","ref":"","in":"body","required":false,"desc":"The name of the video owner or creator","default":"","type":"string","name":"author_name"},{"_id":"56d46a4f73dcd20b00fb8648","ref":"","in":"body","required":false,"desc":"URL to author's Twitter, blog or personal site","default":"","type":"string","name":"author_url"}],"url":"/1/update"},"isReference":true,"order":8,"body":"Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"'https://upload.embed.ly/1/update?key=YOUR_API_KEY' --data 'video_id=YOUR_VIDEO_ID&title=a%20greattitle&description=a%20perfect%20description&author_name=embedly&author_url=http%3A%2F%2Ftwitter.com%2Fembedly'\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nVideo Update Example\n[block:embed]\n{\n  \"html\": \"<iframe class=\\\"embedly-embed\\\" src=\\\"//cdn.embedly.com/widgets/media.html?url=https%3A%2F%2Fjsfiddle.net%2Fjd4w54Lr%2F1%2F&src=https%3A%2F%2Fjsfiddle.net%2Fjd4w54Lr%2F1%2Fembedded%2F&type=text%2Fhtml&key=02466f963b9b4bb8845a05b53d3235d7&schema=jsfiddle\\\" width=\\\"600\\\" height=\\\"400\\\" scrolling=\\\"no\\\" frameborder=\\\"0\\\" allowfullscreen></iframe>\",\n  \"url\": \"https://jsfiddle.net/jd4w54Lr/1/\",\n  \"title\": \"Embedly Video Update - JSFiddle\",\n  \"favicon\": \"https://jsfiddle.net/favicon.png\"\n}\n[/block]","excerpt":"","slug":"update","type":"endpoint","title":"/1/update"}

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

video_id:
required
string
The id of the video to update
title:
string
A title for video
description:
string
A description for video
author_name:
string
The name of the video owner or creator
author_url:
string
URL to author's Twitter, blog or personal site

Result Format


Documentation

Examples [block:code] { "codes": [ { "code": "'https://upload.embed.ly/1/update?key=YOUR_API_KEY' --data 'video_id=YOUR_VIDEO_ID&title=a%20greattitle&description=a%20perfect%20description&author_name=embedly&author_url=http%3A%2F%2Ftwitter.com%2Fembedly'", "language": "curl" } ] } [/block] Video Update Example [block:embed] { "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?url=https%3A%2F%2Fjsfiddle.net%2Fjd4w54Lr%2F1%2F&src=https%3A%2F%2Fjsfiddle.net%2Fjd4w54Lr%2F1%2Fembedded%2F&type=text%2Fhtml&key=02466f963b9b4bb8845a05b53d3235d7&schema=jsfiddle\" width=\"600\" height=\"400\" scrolling=\"no\" frameborder=\"0\" allowfullscreen></iframe>", "url": "https://jsfiddle.net/jd4w54Lr/1/", "title": "Embedly Video Update - JSFiddle", "favicon": "https://jsfiddle.net/favicon.png" } [/block]