Upload Destinations

Each rendered video will be uploaded to a destination you specify. Each destination type requires different kind of information (e.g. authentication, naming, etc). Please refer to the information in the sections below to see a list of required and optional settings for each destination type.

Topics

• Amazon S3
• Microsoft Azure Blob Storage
• HTTP Servers
• FTP Servers
• Youtube
• Facebook
• Dropbox

Amazon S3

Field	Required	Type	Default	Description
type	Required	String		"s3"
bucket	Required	String		Name of the destination bucket
filename	Required	String		Filename for the destination object
aws_access_key_id	Optional	String
aws_secret_access_key	Optional	String
aws_use_policy	Optional	Boolean	false	Use Bucket policy instead of access key/secret.
s3host	Optional	String		For Signature V4 regions (e.g. eu-central-1), the S3 endpoint is required.
secure	Optional	Boolean	false	Force generation of HTTPS URLs in response.
contenttype	Optional	String	"application/octet-stream"	Mediatype (MIME) for the destination object.
contentdisposition	Optional	String		Content disposition type for the destination object.
acl	Optional	String	"public-read"	Access Control for the destination object. Can be one of: private | public-read | public-read-write | authenticated-read
reduced_redundancy	Optional	Boolean	false	Use reduced redundancy for the destination object.
cachecontrol	Optional	String		Extra controls for the "Cache-Control"-header.
metadata	Optional	Hashmap / Dictionary		Extra Metadata ("x-amz-meta-*")

Microsoft Azure Blob Storage

Field	Required	Type	Default	Description
type	Required	String		"azureblob"
account	Required	String		Storage account name
key	Required	String		Storage Key
container	Optional	String		Name of storage container
filename	Required	String		Filename for the destination object
contenttype	Optional	String	"application/octet-stream"	Mediatype (MIME) for the destination object.

HTTP Servers

Field	Required	Type	Default	Description
type	Required	String		"http"
method	Optional	String	POST	"POST" | "GET"
url	Required	String		URL of HTTP upload endpoint
filename	Required	String		Filename for the destination object
user	Optional	String		Basic Auth: username
password	Optional	String		Basic Auth: password
fileid	Optional	String	"file"	Identifier for file in multipart/form-data
fields	Optional	Hashmap	{}	Optional dictionary of form-fields
headers	Optional	Hashmap	{}	Optional dictionary of HTTP headers

FTP Servers

Field	Required	Type	Default	Description
type	Required	String		"ftp"
host	Required	String		Hostname
user	Optional	String		Authentication: username
password	Optional	String		Authentication: password
filename	Required	String		Full pathname for destination
passive	Optional	Boolean	false	Use PASSIVE mode
epsv	Optional	Boolean	false	Use Extended Passive mode

Youtube

Please note: YouTube uploads are subject to very low limits/quotas on the YouTube side, that are not well documented and could change at any time. The usual limit is apparently ~400 videos per day, but depending on circumstances has been observed to be as low as 50 videos per hour per channel. At the moment we can not recommend to use the YouTube upload for any substantial amount of dynamic videos. For further information see the YouTube Terms and Condition

Field	Required	Type	Default	Description
type	Required	String		"youtube"
oauth_access_token	Optional	String		Google/Youtube OAUTH token
auth_secret	Optional	String		ImpossibleFX auth secret
title	Required	String		Video title
description	Required	String		Video description
category	Required	String		Numerical ID for category. See List of categories
status	Required	String	"public"	"private", "public", "unlisted"
tags	Optional	List of strings		Tags, e.g. ["tag1", "tag2"]
playlistid	Optional	String		Add video to playlist (playlistID, not name!)
notifySubscribers	Optional	Boolean	true	Tags, e.g. ["tag1", "tag2"]
mimetype	optional	String	video/mp4	MIME-Type of uploaded video

Facebook

Field	Required	Type	Default	Description
type	Required	String		"facebook"
oauth_access_token	Optional	String		Facebook OAUTH token
title	Required	String		Video title
description	Required	String		Video description
caption	Optional	String		Video caption
name	Optional	Strings		Name for the video

Dropbox

Field	Required	Type	Default	Description
type	Required	String		"dropbox"
oauth_access_token	Optional	String		Dropbox OAUTH token
auth_secret	Optional	String		ImpossibleFX auth secret
filename	Required	String		Filename for the destination object