POST /accounts/{account_id}/stream/{identifier}

Edit details for a single video.

Servers

Path parameters

Name Type Required Description
identifier String Yes
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"

Request body fields

Name Type Required Description
maxDurationSeconds Integer No

The maximum duration in seconds for a video upload. Can be set for a video that is not yet uploaded to limit its duration. Uploads that exceed the specified duration will fail during processing. A value of -1 means the value is unknown.

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.

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

uploadExpiry String No

The date and time when the video upload URL is no longer valid for direct user uploads.

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

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.