Upload videos via direct upload URLs

Creates a direct upload that allows video uploads without an API key.

Request

Path Params

account_identifier

string

required

Body Params application/json

allowedOrigins

array[string]

optional

Lists the origins allowed to display the video. Enter allowed origin domains in an array and use * for wildcard subdomains. Empty arrays allow the video to be viewed on any origin.

Example:

["example.com"]

creator

string

optional

A user-defined identifier for the media creator.

<= 64 characters

Example:

creator-id_abcde12345

expiry

string <date-time>

optional

The date and time after upload when videos will not be accepted.

Default:

Now + 30 minutes

Example:

2021-01-02T02:20:00Z

maxDurationSeconds

integer

required

Calculates the amount of time a video occupies before the video is uploaded. Direct uploads occupy minutes of videos on your Stream account until they are expired. After upload, the upload duration is used instead. If a video longer than the value is uploaded, the video results in an error.

>= 1<= 21600

thumbnailTimestampPct

number

optional

The timestamp for a thumbnail image calculated as a percentage value of the video's duration. To convert from a second-wise timestamp to a percentage, divide the desired timestamp by the total duration of the video. If this value is not set, the default thumbnail image is taken from 0s of the video.

>= 0<= 1

Default:

Example:

0.529241

watermark

object (watermark_at_upload)

optional

uid

string

optional

The unique identifier for the watermark profile.

<= 32 characters

Example:

ea95132c15732412d22c1476fa83f27a

Example

{
    "allowedOrigins": [
        "example.com"
    ],
    "creator": "creator-id_abcde12345",
    "expiry": "2021-01-02T02:20:00Z",
    "maxDurationSeconds": 1,
    "thumbnailTimestampPct": 0.529241,
    "watermark": {
        "uid": "ea95132c15732412d22c1476fa83f27a"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Upload videos via direct upload URLs response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "uid": "ea95132c15732412d22c1476fa83f27a",
        "uploadURL": "www.example.com/samplepath",
        "watermark": {
            "created": "2014-01-02T02:20:00Z",
            "downloadedFrom": "https://company.com/logo.png",
            "height": 0,
            "name": "Marketing Videos",
            "opacity": 0.75,
            "padding": 0.1,
            "position": "center",
            "scale": 0.1,
            "size": 29472,
            "uid": "ea95132c15732412d22c1476fa83f27a",
            "width": 0
        }
    },
    "success": true
}

🟢200Upload videos via direct upload URLs response failure