Skip to main content
POST
Create an upload

Authorizations

Authorization
string
header
required

API key issued by Hooper for your organization. Keys are environment-tagged: hk_prod_ keys work against production, hk_stg_ keys against staging.

Body

application/json
size
integer
required

The file's exact size in bytes; upload_url accepts exactly that many. Max 10 GB for a video, 5 MB for an image.

Example:

2147483648

content_type
enum<string>
default:video/mp4

A video type for a session source, an image type for branding.

Available options:
video/mp4,
video/quicktime,
image/png,
image/jpeg,
image/webp
filename
string

Response

Upload session created

id
string
Example:

"up_3f9a1c2b7e5d4a08"

object
string
Allowed value: "upload"
upload_url
string

Resumable upload URL. PUT the bytes here.

content_type
string
size
integer
expires_in_seconds
integer

How long upload_url accepts the PUT. The stored file does not expire.

Example:

604800