Skip to main content
POST
Repackage Video

Authorizations

AccessKey
string
header
required

AccessKey based authentication

Path Parameters

libraryId
integer<int64>
required

The ID of the video library.

videoId
string
required

The GUID of the video.

Query Parameters

keepOriginalFiles
boolean
default:true

Marks whether previous file versions should be kept in storage, allows for faster repackage later on. Default is true.

Response

The details of the requested video

videoLibraryId
integer<int64>
required

The ID of the video library that the video belongs to

guid
string
required

The unique ID of the video

Minimum string length: 1
title
string
required

The title of the video

Minimum string length: 1
dateUploaded
string<date-time>
required

The date when the video was uploaded

Minimum string length: 1
views
integer<int64>
required

The number of views the video received

isPublic
boolean
required

Determines if the video is publically accessible

length
integer<int32>
required

The duration of the video in seconds

status
required

The status of the video. See VideoModelStatus.

Available options:
0
framerate
number<double>
required

The framerate of the video

width
integer<int32>
required

The width of the original video file

height
integer<int32>
required

The height of the original video file

outputCodecs
string
required

Comma-separated list of output codecs generated for this video (e.g. "x264,vp9"). See EncoderOutputCodec for possible values.

Minimum string length: 1
thumbnailCount
integer<int32>
required

The number of thumbnails generated for this video

encodeProgress
integer<int32>
required

Encoding progress as a percentage from 0 to 100; reaches 100 when transcoding finishes.

storageSize
integer<int64>
required

Total storage used by this video, in bytes.

hasMP4Fallback
boolean
required

Determines if the video has MP4 fallback files generated

averageWatchTime
integer<int64>
required

The average watch time of the video in seconds

totalWatchTime
integer<int64>
required

The total video watch time in seconds

description
string | null

The description of the video

rotation
integer | null

Rotation of the source file in degrees as read from container metadata (e.g. 90, -90, 180, 270); null when no rotation metadata is present.

availableResolutions
string | null

Comma-separated list of resolution labels (e.g. "360p,720p,1080p") that have finished encoding and are available for playback.

captions
object[] | null

The list of captions available for the video

collectionId
string | null

The ID of the collection where the video belongs

thumbnailFileName
string | null

The file name of the thumbnail inside of the storage

thumbnailUrl
string | null

The CDN URL of the thumbnail

thumbnailBlurhash
string | null

Thumbnail blurhash to show while the actual thumbnail is being loaded

category
string | null

Automatically detected content category label; "untagged" when no category has been determined yet.

chapters
object[] | null

The list of chapters available for the video

moments
object[] | null

The list of moments available for the video

metaTags
object[] | null

The list of meta tags that have been added to the video

transcodingMessages
object[] | null

The list of transcoding messages that describe potential issues while the video was transcoding

jitEncodingEnabled
boolean | null

Whether just-in-time encoding is enabled for this specific video, overriding the video library's default JitEncodingEnabled setting when set. Null means the library default applies.

smartGenerateStatus

Aggregate smart generate status derived from per-feature statuses when present: InProgress, then Queued, then Failed, then Finished; otherwise the stored legacy value. See SmartGenerateFeaturesStatus.

Available options:
0
smartGenerateFeaturesStatus
object | null

Per-feature smart generate statuses (title, description, chapters, moments). Null for a feature on legacy rows.

hasOriginal
boolean | null

Determines if video has the original file available in storage

originalHash
string | null

Original uploaded file SHA256 hash

hasHighQualityPreview
boolean | null

Whether a high-quality animated preview has been generated for this video.

Last modified on September 10, 2026