Amazon S3

Upload a rendered video or image to an Amazon AWS S3 bucket.

Bucket Authentication can be either via Access Key ID / Secret Access Key or via a bucket policy that allows Impossible Software to upload objects. To use policy based authentication create a bucket policy that includes the AWS Canonical User 1ea9f667f8ec65aa76ca17cbacfda01ba70493b59f7124a810823def30e10216 to upload object. See example further down.

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-*")

Example S3 Bucket policy

 "Id": "Policy1399574260984",
 "Statement": [
     "Sid": "Stmt1399574252698",
     "Action": [
     "Effect": "Allow",
     "Resource": "arn:aws:s3:::BUCKET_NAME/*",
     "Principal": {

Example Request:

curl -X POST
     -H "Content-type: application/json" -d '
    "movie": "Movie Name",
    "params": {
        Movie Parameters
    "upload": {
        "extension": "mp4",
        "async": false,
        "destination":  {
            "type": "s3",
            "aws_access_key_id": "AWS Access Key ID",
            "aws_secret_access_key": "AWS Secret Access Key",
            "filename": "myvideos/my-movie-123.mp4",
            "contenttype": "video/mp4",
            "bucket": "mybucket",
            "acl": "public-read",

Example Response:

    "token": Token,
    "upload": ""

Terms of Use | © 2017, Impossible Software, or its affiliates. All rights reserved.