Create a clip from a `renditions` VOD media

put

https://api.jwplayer.com/v2/sites/{site_id}/media/{media_id}/clip/

Creates a new renditions (CMAF VOD) media by clipping an existing renditions VOD source. Clip in/out points are optional; if omitted, the full source media is captured. The new media inherits DRM settings from the source unless overridden in metadata. The DRM setting on the new media can also be updated at any time using the update media endpoint.

Path Params

site_id

string

required

length between 8 and 8

Unique alphanumeric ID of the site

media_id

string

required

length between 8 and 8

Unique alphanumeric ID of the media

Body Params

clip_in_point

string

Clip start time. Accepts either an offset in HH:MM:SS.mmm format (e.g. "00:01:30.500") or an ISO-8601 absolute datetime (e.g. "2024-01-02T03:04:05.000Z").

When both clip_in_point and clip_out_point are supplied they must use the same format, and if both are ISO-8601 they must both include or both omit a timezone.

clip_out_point

string

Clip end time. Accepts either an offset in HH:MM:SS.mmm format (e.g. "00:05:00.000") or an ISO-8601 absolute datetime (e.g. "2024-01-02T03:04:10.000Z").

When both clip_in_point and clip_out_point are supplied they must use the same format, and if both are ISO-8601 they must both include or both omit a timezone.

metadata

object

Responses

201Clipped media successfully created

400Invalid JSON request body

404Resource with ID supplied does not exist in account and object namespace

422Unprocessable Entity