Skip to main content
POST
Create or resume a TUS upload session

Authorizations

payload-token
string
cookie
required

Payload authentication cookie. These endpoints run Payload access control; an authenticated admin session is required.

Body

application/json
collection
string
required

Target upload collection.

filename
string
required

Original file name.

filesize
number
required

File size in bytes.

filetype
string
required

File MIME type.

title
string

Video title. Required when creating a new video.

videoId
string

Existing Bunny video GUID, to resume an upload.

Response

TUS authorization for a new/resumed upload, or an uploaded short-circuit when the video is already processed.

authorizationExpire
number

Signature expiry as a UNIX timestamp (seconds).

authorizationSignature
string

SHA-256 TUS authorization signature.

libraryId
number

Bunny Stream library the video lives in.

thumbnailTime
number

Thumbnail capture time (ms), when configured.

type
enum<string>

upload returns a signature to proceed; uploaded means the video already exists.

Available options:
upload,
uploaded
videoId
string

Bunny video GUID.