WIwistia
Trims

Create Media from Trims

Changed on

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

Tokens with the "Act with a team member's permissions" permission (all:delegate_to_contact_permissions scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token.

An expiring access token created with the all:delegate_to_contact_permissions scope and an authorization granting the edit permission on this media can also be used.

post/medias/{mediaHashedId}/trims

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/medias/{mediaHashedId}/trims
  • Auth
    HTTP bearer

Path parameters

mediaHashedIdstring required

The hashed ID of the media.

Headers

X-Wistia-API-Versionstring required

Request body

trimsstring[] 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.

keep_trimsboolean

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

Response

Successful queueing of trims worker.

Changes