API Reference
Wistia Learning CenterWistia
Start typing to search…

Create Media from Trims

post
https://api.wistia.com/modern/medias//trims

Creates a new media that trims off parts of an existing media.

By default, the trims parameter specifies time ranges to remove from the media. When keep_trims is set to true, the trims parameter instead specifies time ranges to keep in the media.

NOTE: currently this endpoint only supports trimming video files.

Requires api token with one of the following permissions

Read, update & delete anything
Path Params
string
required

The hashed ID of the media.

Body Params
trims
array of strings
required

An array of strings matching the format of HH:MM:SS.mmm-HH:MM:SS.mmm where HH is hours, MM is minutes, SS is seconds and mmm is milliseconds. When keep_trims is false (default), the ranges specify parts of the media to remove. When keep_trims is true, the ranges specify parts of the media to keep.

trims*
boolean
Defaults to false

When set to true, the trims parameter is treated as ranges to keep rather than ranges to remove. Defaults to false.

Headers
string
required
Defaults to 2026-03
Responses

Updated about 1 month ago

Language
Credentials
Bearer
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated about 1 month ago