Before creating a video you must first generate an upload signature and upload your source video. The upload signature allows you to upload directly to the vzaar upload bucket on AWS S3. Once your video has been successfully uploaded, you can then proceed with video creation.
Unless you are implementing your own custom upload process, this should be handled by the official client library of your choice.
For more information about upload signatures, please refer to the Upload Signatures documentation.
The ability to categorise a video is only available via
PATCHrequests. When categorising a video, please take note of the following three scenarios:
- If you do not specify the
category_idsparameter, any existing categorisation will remain untouched.
- If you specify an empty array for
category_idsall existing categorisation will be lost i.e. you are specifying that your video should be in no categories.
- If you provide one or more category id values for
category_idsyour video will be categorised to match your provided values i.e. all previous categorisation is removed and the video is recategorised based on the values you provide.