Videos
Uploading, importing, editing and deleting videos; their formats, captions, GIFs, protection and watermarks.
Sign Upload Parts
Signed URLs to PUT the given parts of the source at (Create Video's `upload`).
Complete Upload
After the browser put every part of the source in the storage (Create Video's
Replace Video File
Starts uploading a new file in place of the video's source, in parts as Create
Cancel Replacing Video File
Drops the new file's upload: the video is as it was. Not being replaced, nothing.
List My Uploads
The user's last uploads and imports, newest first, across the projects they can see
Get Video
Get Video
Delete Video
Into the project's trash, where it's hidden and can be restored (List Trash, Restore
Update Video
Only what's sent changes.
Get Video Keeping Choices
What may be picked of how the video is kept, now.
Get Encoding Email
Whether the signed-in user is emailed once the video has finished encoding.
Turn On Encoding Email
Email the signed-in user once every format has finished encoding (or failed). 400
Turn Off Encoding Email
Turn Off Encoding Email
Set Video Audio
Brings its sound to one loudness, or leaves it as it is: each format's audio is
List Video Events
List Video Events
Create Format
Starts encoding the video into a format, at most one per codec: again for a failed
Retry Format
Encodes a failed format's failed parts again, into it, while the rest of it plays or
Delete Format
Removes a format of the video and its files: not while part of it is encoding, nor
Suggest Chapters
Chapters read from the video's captions (an uploaded track before a made one) by
Clip Video
A new video of the parts kept, joined in time order, its picture turned and cropped
Trim Video
Cuts the video's own source to the parts kept, joined in time order, its picture
Keep Sandbox Video
Keeps a Sandbox video (`expires_at`) once its organisation is on a plan without a
Set Video Thumbnail Frame
A frame of the video as its thumbnail: macaron makes it; the project's pages get a thumbnail_status message once it's done.
Upload Video Thumbnail
A JPEG, PNG or WebP image of up to 10 MB, stored as a JPEG of at most 1920 pixels a
Upload Captions
A WebVTT or SRT file of up to 5 MB, in place of the video's upload in that
Generate Captions
macaron writes down the speech, in the language given or the one it hears; the
Delete Captions
Delete Captions
Get Caption Cues
A ready track's cues, for the manage page's editor; 409 while it's being made.
Update Caption Cues
In place of the track's, as players get them from then on. Answers with them as
List GIFs
Newest first, those still being made too.
Create GIF
macaron makes it of the part asked for; it's `processing` until then, and the
Delete GIF
Delete GIF
Set Video Protection
Encrypts its files (AES-128 or DRM), or keeps them in clear: every format is encoded
Set Video Watermarks
Marks its renditions, or stops, or picks another watermark: every format is encoded
List Traces
Leaked copies of a forensic video, newest first, with the viewers they match.
Trace Leaked Copy
A leaked copy of the video, read for its viewers' marks: queued,
Delete Trace
Delete Trace
Run Workflow
Runs one of its project's workflows on the ready video: its
Create Video
A new video, its source to upload in parts (`upload`): sign them with Sign Upload
List Videos
List Videos
Import Video
A new video from a public URL of its file.
Delete Videos
Each as Delete Video does: into the project's trash if it keeps one, else for good.
Move Videos
Into `folder_id`, or the top level with null. All of them or none: 404 if one of them
Add Label to Videos
Adds the label to each (those with it keep it). All of them or none: 404 if one of them
Remove Label from Videos
Takes the label off each (those without it stay so). All of them or none: 404 if one
List Trash
What's in the project's trash, the last deleted first, and when each is deleted for
Restore Videos
Back out of the trash as they were, to the top level if their folder was deleted.
Delete Videos For Good
Out of the trash for good, their files and analytics too: this can't be undone. 404
Empty Trash
Everything in the project's trash, for good: this can't be undone.