Upload videos from a URL

POST

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/stream/copy

Last modified:2022-12-16 13:48:35

Uploads a video to Stream from a provided URL.

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

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

url

string <uri>

required

A video's URL. The server must be publicly routable and support HTTP HEAD requests and HTTP GET range requests. The server should respond to HTTP HEAD requests with a content-range header that includes the size of the file.

Example:

https://example.com/myvideo.mp4

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",
    "thumbnailTimestampPct": 0.529241,
    "url": "https://example.com/myvideo.mp4",
    "watermark": {
        "uid": "ea95132c15732412d22c1476fa83f27a"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//stream/copy' \
--header 'Content-Type: application/json' \
--data-raw '{
    "allowedOrigins": [
        "example.com"
    ],
    "creator": "creator-id_abcde12345",
    "thumbnailTimestampPct": 0.529241,
    "url": "https://example.com/myvideo.mp4",
    "watermark": {
        "uid": "ea95132c15732412d22c1476fa83f27a"
    }
}'

Responses

🟢200Upload videos from a URL 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": {},
    "success": true
}

🟢200Upload videos from a URL response failure

Modified at 2022-12-16 13:48:35

Initiate video uploads using TUS

Upload videos via direct upload URLs