POST /accounts/{account_id}/stream/copy

Uploads a video to Stream from a provided URL.

Servers

Path parameters

Name Type Required Description
account_id String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Upload-Creator String No

Request body fields

Name Type Required Description
scheduledDeletion String No

Indicates the date and time at which the video will be deleted. Omit the field to indicate no change, or include with a null value to remove an existing scheduled deletion. If specified, must be at least 30 days from upload time.

url String Yes

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.

meta Object No

A user modifiable key-value store used to reference other systems of record for managing videos.

allowedOrigins[] Array No

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.

requireSignedURLs Boolean No

Indicates whether the video can be a accessed using the UID. When set to true, a signed token must be generated with a signing key to view the video.

Default value: false

thumbnailTimestampPct Number No

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.

Default value: 0

watermark Object No
watermark.uid String No

The unique identifier for the watermark profile.

creator String No

A user-defined identifier for the media creator.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.