Upload with an upload token
When given a token, anyone can upload a file to the URI https://ws.api.video/upload?token=<tokenId>.
Example with cURL:
$ curl --request POST --url 'https://ws.api.video/upload?token=toXXX'
--header 'content-type: multipart/form-data'
-F file=@video.mp4
Or in an HTML form, with a little JavaScript to convert the form into JSON:
<!--form for user interaction-->
<form name="videoUploadForm" >
<label for=video>Video:</label>
<input type=file name=source/><br/>
<input value="Submit" type="submit">
</form>
<div></div>
<!--JS takes the form data
uses FormData to turn the response into JSON.
then uses POST to upload the video file.
Update the token parameter in the url to your upload token.
-->
<script>
var form = document.forms.namedItem("videoUploadForm");
form.addEventListener('submit', function(ev) {
ev.preventDefault();
var oOutput = document.querySelector("div"),
oData = new FormData(form);
var oReq = new XMLHttpRequest();
oReq.open("POST", "https://ws.api.video/upload?token=toXXX", true);
oReq.send(oData);
oReq.onload = function(oEvent) {
if (oReq.status ==201) {
oOutput.innerHTML = "Your video is uploaded!<br/>" + oReq.response;
} else {
oOutput.innerHTML = "Error " + oReq.status + " occurred when trying to upload your file.<br \/>";
}
};
}, false);
</script>
Dealing with large files
You can upload large files on api.video with <a href='https://docs.api.video/reference/post_videos-videoid-source'>Progressive Upload</a>. Alternatively, if you want to use regular upload, we have created a <a href='https://api.video/blog/tutorials/uploading-large-files-with-javascript'>tutorial</a> to walk through the steps required.
Query parameters
The unique identifier for the token you want to use to upload a video.
Headers
Content-Range represents the range of bytes that will be returned as a result of the request. Byte ranges are inclusive, meaning that bytes 0-999 represents the first 1000 bytes in a file or object.
Response
Created
Example response
{
"videoId": "vi4k0jvEUuaTdRAEjQ4Jfrgz",
"title": "Maths video",
"description": "An amazing video explaining the string theory",
"tags": [
"maths",
"string theory",
"video"
],
"metadata": [
{
"key": "Author",
"value": "John Doe"
},
{
"key": "Format",
"value": "Tutorial"
}
],
"createdAt": "4251-03-03T12:52:03.085Z",
"publishedAt": "4665-07-14T23:36:18.598Z",
"actions": [
"video_delete",
"video_download",
"video_update"
]
}