Skip to main content
POST
Cut one or more time ranges from a clip

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video identifier

Example:

"vid_abc123def456"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Body

application/json

Cut one or more time ranges from the clip in a single request. Provide either cuts: [{fromMs, toMs}, ...] (preferred) or the legacy single-range fromMs/toMs pair. Overlapping or adjacent ranges are merged into the clip's existing cuts.

cuts
object[]

Time ranges to cut from the clip. Merged with the clip's existing cuts; overlapping or adjacent ranges are joined.

Minimum array length: 1
fromMs
integer

Single-range shortcut for cuts: [{fromMs, toMs}]. Use cuts for multiple ranges.

Required range: 0 <= x <= 9007199254740991
Example:

2000

toMs
integer

Single-range shortcut for cuts: [{fromMs, toMs}]. Use cuts for multiple ranges.

Required range: x <= 9007199254740991
Example:

3500

Response

OK

Response shape for a single clip

clip
object
required

A section of a video